Wymagane parametry żądania

Aby wysłać żądanie do interfejsu Maps Datasets API, musisz podać:

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

  Uwaga: jeśli do uwierzytelniania używasz konta usługi, możesz pominąć nagłówek X-Goog-User-Project. Więcej informacji o kontach usługi znajdziesz w artykule Uwierzytelnianie w Google.

• 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, który jest określony w nagłówku X-Goog-User-Project, ale nie musi tak być.

• Identyfikator zbioru danych w adresie URL żądania. Gdy wykonujesz jakieś działanie na konkretnym zbiorze danych, przekazujesz jego identyfikator w adresie URL żądania.

Uwaga: niektóre żądania wymagają dodatkowych parametrów opisanych w dokumentacji dotyczącej tych żądań.

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

Uzyskaj numer projektu

Aby uzyskać 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 są widoczne w obszarze Informacje o projekcie na ekranie przeglądu.

Pobieranie tokena OAuth

Uwaga: procedura generowania tokena OAuth opisana poniżej nie jest przeznaczona do użytku w środowisku produkcyjnym. Stosuj tę procedurę tylko w środowisku programistycznym lub testowym.

Aby można było uwierzytelnić żądanie, w nagłówku Authorization musi ono zawierać token OAuth. Więcej informacji znajdziesz w artykule Używanie protokołu OAuth.

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

gcloud auth application-default print-access-token

Aby wygenerować nowy token w przypadku każdego żądania, możesz umieścić polecenie gcloud bezpośrednio w nagłówku Authorization w komendach cURL, tak 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