Wymagane parametry żądania

Aby wysłać jakiekolwiek żądanie do interfejsu Maps Datasets API, musisz uwzględnić:

  • numer lub identyfikator projektu Google Cloud w nagłówku X-Goog-User-Project żądania. Ta wartość określa projekt używany do rozliczeń i obliczania limitu wykorzystania.

  • token OAuth w nagłówku Authorization żądania. Więcej informacji o używaniu OAuth z interfejsem Maps Datasets API znajdziesz w artykule Używanie OAuth.

  • numer lub identyfikator projektu Google Cloud w adresie URL żądania. Ta wartość określa projekt zawierający zbiór danych. Zwykle jest to ten sam projekt co projekt określony w nagłówku X-Goog-User-Project, ale nie jest to wymagane.

  • identyfikator zbioru danych w adresie URL żądania. Gdy wykonujesz działanie na określonym zbiorze danych, przekazujesz identyfikator zbioru danych jako część adresu URL żądania.

Aby na przykład usunąć zbiór danych:

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

Pobieranie numeru projektu

Aby uzyskać wartość PROJECT_NUMBER_OR_ID projektu Google Cloud:

  1. W konsoli Cloud otwórz stronę Przegląd projektu.

  2. Jeśli pojawi się taka prośba, wybierz projekt.

  3. Numer projektu i Identyfikator projektu pojawią się w obszarze Informacje o projekcie na ekranie przeglądu.

Pobieranie tokena OAuth

Aby uwierzytelnić się, żądanie do interfejsu API musi zawierać token OAuth w nagłówku Authorization. Więcej informacji znajdziesz w artykule Używanie OAuth.

Aby na przykład wygenerować token, użyj tego polecenia gcloud:

gcloud auth application-default print-access-token

Polecenie gcloud możesz umieścić bezpośrednio w nagłówku Authorization w poleceniu cURL, aby wygenerować nowy token przy każdym żądaniu, jak pokazano w przykładzie powyżej.

Możesz też ustawić zmienną środowiskową zawierającą token, a następnie przekazać ją jako część żądania:

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