Wymagane parametry żądania

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

• Numer lub identyfikator projektu Google Cloud w sekcji Nagłówek 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ąć ten krok w nagłówku X-Goog-User-Project. Więcej informacji na temat: kont usługi, zobacz 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. Ten projekt jest zwykle taki sam jak projekt określony w nagłówku X-Goog-User-Project, nie musi być taka sama.

• Identyfikator zbioru danych w adresie URL żądania. Za każdym razem, gdy wykonujesz działanie na należy przekazać jego identyfikator do adresu URL żądania.

Uwaga: niektóre żądania wymagają dodatkowych parametrów opisanych w dokumentację dotyczącą 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

Uzyskiwanie numeru projektu

Aby uzyskać PROJECT_NUMBER_OR_ID z projektu Google Cloud:

1. Otwórz Strona Przegląd w konsoli Cloud.

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

3. Numer projektu i Identyfikator projektu pojawią się w Informacjach o projekcie. obszaru ekranu przeglądu.

Uzyskiwanie tokena OAuth

Uwaga: poniższa procedura generowania tokena OAuth nie jest przeznaczona do stosowania w środowisku produkcyjnym. Użyj tej procedury do programowania lub testowania i środowisko.

W celu uwierzytelnienia żądanie interfejsu API musi zawierać token OAuth w sekcji Nagłówek Authorization. Więcej informacji znajdziesz w artykule Używanie protokołu OAuth.

Na przykład do wygenerowania tokena 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 cURL, aby wygenerować nowy token dla każdego żądania, tak jak w przykładzie. powyżej.

Możesz też ustawić zmienną środowiskową zawierającą token, a następnie i prześlij zmienną środowiskową w ramach żą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