A API Datasets está em pré-lançamento (pré-GA). Os produtos e recursos pré-GA têm suporte limitado, e as mudanças neles podem não ser compatíveis com outras versões pré-GA. As ofertas pré-GA são cobertas pelos Termos de serviço específicos da Plataforma Google Maps. Para mais informações, consulte as descrições da fase de lançamento.

Esta página foi traduzida pela API Cloud Translation.

Switch to English

Parâmetros de solicitação obrigatórios

Para fazer uma solicitação à API Datasets, você precisa incluir:

O número ou ID do seu projeto do Google Cloud no cabeçalho X-Goog-User-Project da solicitação. Esse valor determina o projeto usado para faturamento e cálculos de cota de uso.

Observação: se você estiver usando uma conta de serviço para autenticação, poderá omitir o cabeçalho X-Goog-User-Project. Para mais informações sobre contas de serviço, consulte Autenticação no Google.
Um token OAuth no cabeçalho Authorization da solicitação. Para saber mais sobre como usar o OAuth com a API Maps Datasets, consulte Usar o OAuth.
Um número ou ID de projeto do Google Cloud no URL da solicitação. Esse valor especifica o projeto que contém o conjunto de dados. Embora esse projeto geralmente seja o mesmo que o especificado no cabeçalho X-Goog-User-Project, ele não precisa ser o mesmo.
O ID do conjunto de dados no URL da solicitação. Sempre que você executar uma ação em um conjunto de dados específico, você transmitirá o ID do conjunto de dados como parte do URL da solicitação.

Por exemplo, para excluir um conjunto de dados:

curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

Conferir o número do projeto

Para receber o PROJECT_NUMBER_OR_ID do seu projeto do Google Cloud:

Acesse a página Visão geral do projeto no Console do Cloud.
Se solicitado, selecione o projeto.
O Número do projeto e o ID do projeto aparecem na área Informações do projeto da tela de visão geral.

Receber um token OAuth

Para autenticação, sua solicitação de API precisa conter um token OAuth no cabeçalho Authorization. Para mais informações, consulte Usar o OAuth.

Por exemplo, use o seguinte comando gcloud para gerar o token:

gcloud auth application-default print-access-token

É possível incluir o comando gcloud diretamente no cabeçalho Authorization em um comando cURL para gerar um novo token em cada solicitação, conforme mostrado no exemplo acima.

Outra opção é definir uma variável de ambiente contendo o token e transmitir a variável de ambiente como parte da solicitação:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID