Parâmetros de solicitação obrigatórios

Para fazer uma 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 cota de faturamento e 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 de contas de serviço, consulte Autenticação no Google.

• Um token 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 normalmente igual ao projeto especificado no cabeçalho X-Goog-User-Project, não precisa ser igual.

• O ID do conjunto de dados no URL da solicitação. Sempre que você realizar uma ação conjunto de dados específico, você transmite o ID do conjunto de dados como parte do URL de solicitação.

.

Observação: algumas solicitações exigem parâmetros adicionais que estão descritos nas documentação sobre essas solicitações.

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

Descubra o número do projeto

Para receber o PROJECT_NUMBER_OR_ID do seu projeto do Google Cloud:

1. Acesse a Página de visão geral 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

Observação: o procedimento abaixo para gerar um token OAuth não se destina ao uso em um ambiente de produção. Use este procedimento para um desenvolvimento ou teste em um ambiente seguro.

Para autenticação, a solicitação da 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.

Como alternativa, defina uma variável de ambiente que contenha o token e transmita-a 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