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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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)

1 回限りのインポートに使用するデータセットのローカル ファイルソース。

gcsSource

object (GcsSource)

1 回限りのインポートに使用するデータセットの 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 のドキュメントをご覧ください。