Method: media.upload

匯入資料集的新版本資料。

HTTP 要求

  • 上傳 URI (適用於媒體上傳要求)：
    POST https://mapsplatformdatasets.googleapis.com/upload/v1/{name=projects/*/datasets/*}:import
  • 中繼資料 URI (適用於僅中繼資料的要求)：
    POST https://mapsplatformdatasets.googleapis.com/v1/{name=projects/*/datasets/*}:import

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要欄位。資源名稱。格式：projects/{project}/datasets/{datasetId}

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "versionDescription": string,

  // Union field data_source can be only one of the following:
  "localFileSource": {
    object (LocalFileSource)
  },
  "gcsSource": {
    object (GcsSource)
  }
  // End of list of possible types for union field data_source.
}
欄位
versionDescription

string

說明匯入的新資料。
聯集欄位 data_source。資料集資料來源的詳細資料。data_source 只能是下列其中一項：
localFileSource

object (LocalFileSource)

一次性匯入資料集的本機檔案來源。
gcsSource

object (GcsSource)

資料集的 Google Cloud Storage 檔案來源 (一次性匯入)。

回應主體

media.upload 的回應物件。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "name": string
}
欄位
name

string

必要欄位。新建立資料集版本的資源名稱。格式：projects/{project}/datasets/{datasetId}@{versionId}

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/cloud-platform

身分與存取權管理權限

必須具備 name 資源的下列 IAM 權限：

  • mapsplatformdatasets.datasets.import

詳情請參閱身分與存取權管理說明文件。