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/{dataset_id}

请求正文

请求正文中包含结构如下的数据：

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 文件来源。

响应正文

如果成功，响应正文将包含结构如下的数据：

导入新版本数据集的响应。

JSON 表示法 
{
  "name": string
}
字段
name

string

必需。新创建的数据集版本的资源名称，项目/{项目}/datasets/{dataset_id}@{versionId}

授权范围

需要以下 OAuth 作用域：

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

IAM 权限

需要 name 资源的以下 IAM 权限：

  • mapsplatformdatasets.datasets.import

如需了解详情，请参阅 IAM 文档。