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

IAM 权限

需要拥有 name 资源的以下 IAM 权限:

  • mapsplatformdatasets.datasets.import

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