Method: media.upload

  • Imports a new version of data for a specified dataset using either a local file or Google Cloud Storage source.

  • Requires specifying the dataset name, version description, and data source details in the request body.

  • Successful imports return the resource name of the newly created dataset version.

  • Authorization requires the cloud-platform scope and mapsplatformdatasets.datasets.import permission.

Imports a new version of the data for the dataset.

HTTP request

  • Upload URI, for media upload requests:
    POST https://mapsplatformdatasets.googleapis.com/upload/v1alpha/{name=projects/*/datasets/*}:import
  • Metadata URI, for metadata-only requests:
    POST https://mapsplatformdatasets.googleapis.com/v1alpha/{name=projects/*/datasets/*}:import

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. Resource name, projects/{project}/datasets/{dataset_id}

Request body

The request body contains data with the following structure:

JSON representation 
{
  "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.
}
Fields
versionDescription

string

A description of the new data being imported.
Union field data_source. Details about the source of the data for the dataset. data_source can be only one of the following:
localFileSource

object (LocalFileSource)

A local file source for the dataset for a one time import.
gcsSource

object (GcsSource)

A Google Cloud Storage file source for the dataset for a one time import.

Response body

If successful, the response body contains data with the following structure:

Response from importing a new version of the dataset.

JSON representation 
{
  "name": string
}
Fields
name

string

Required. Resource name of the newly created dataset version, projects/{project}/datasets/{dataset_id}@{versionId}

Authorization Scopes

Requires the following OAuth scope:

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

IAM Permissions

Requires the following IAM permission on the name resource:

  • mapsplatformdatasets.datasets.import

For more information, see the IAM documentation.