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 文档。