Method: media.upload

Importa uma nova versão dos dados para o conjunto de dados.

Solicitação HTTP

  • URI de upload para solicitações de upload de mídia:
    POST https://mapsplatformdatasets.googleapis.com/upload/v1/{name=projects/*/datasets/*}:import
  • URI de metadados, para solicitações somente de metadados:
    POST https://mapsplatformdatasets.googleapis.com/v1/{name=projects/*/datasets/*}:import

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. Nome do recurso. Formato: projects/{project}/datasets/{datasetId}

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação 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.
}
Campos
versionDescription

string

Uma descrição dos novos dados que estão sendo importados.

Campo de união data_source. Detalhes sobre a origem dos dados do conjunto de dados. data_source pode ser apenas de um dos tipos a seguir:
localFileSource

object (LocalFileSource)

Fonte de arquivo local para o conjunto de dados para uma importação única.

gcsSource

object (GcsSource)

Uma origem de arquivo do Google Cloud Storage para o conjunto de dados para uma importação única.

Corpo da resposta

Objeto de resposta de media.upload.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "name": string
}
Campos
name

string

Obrigatório. Nome do recurso da versão recém-criada do conjunto de dados. Formato: projects/{project}/datasets/{datasetId}@{versionId}

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • mapsplatformdatasets.datasets.import

Para mais informações, consulte a documentação do IAM.