- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Permissões do IAM
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 | 
 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 | 
| Campos | |
|---|---|
| versionDescription | 
 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_sourcepode ser apenas de um dos tipos a seguir: | |
| localFileSource | 
 Fonte de arquivo local para o conjunto de dados para uma importação única. | 
| 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 | 
 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.