Parâmetros de solicitação obrigatórios

Para fazer qualquer solicitação à API Maps 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 cálculos de faturamento e cota de uso.

  • Um token do OAuth no cabeçalho Authorization da solicitação. Para mais informações sobre como usar o OAuth com a API Maps Datasets, consulte Usar o OAuth.

  • Um número ou ID do projeto do Google Cloud no URL da solicitação. Esse valor especifica o projeto que contém o conjunto de dados. Embora esse projeto seja geralmente o mesmo especificado no cabeçalho X-Goog-User-Project, não é obrigatório que seja.

  • O ID do conjunto de dados no URL da solicitação. Sempre que você realiza uma ação em um conjunto de dados específico, transmite o ID dele 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

Consiga o número do projeto

Para conferir o PROJECT_NUMBER_OR_ID do seu projeto do Google Cloud:

  1. Acesse a página de visão geral do projeto no console do Cloud.

  2. Se solicitado, selecione o projeto.

  3. 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

Você pode incluir o comando gcloud diretamente no cabeçalho Authorization em um comando cURL para gerar um novo token em cada solicitação, como mostrado no exemplo acima.

Como alternativa, é possível definir uma variável de ambiente que contenha 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