Обязательные параметры запроса

Любой запрос к Maps Datasets API должен содержать:

  • Номер или идентификатор облачного проекта Google Cloud в заголовке запроса X-Goog-User-Project. Это значение определяет проект, который используется для расчета оплаты и квоты на использование.

  • Токен OAuth в заголовке Authorization запроса. Подробнее об использовании OAuth с Maps Datasets API…

  • Номер или идентификатор облачного проекта Google Cloud в URL запроса. Это значение указывает на проект, содержащий набор данных. Обычно это тот же проект, который указан в заголовке X-Goog-User-Project, но это не обязательно.

  • Идентификатор набора данных в URL запроса. При выполнении действия с определенным набором данных вы передаете его идентификатор в URL запроса.

Например, чтобы удалить набор данных, выполните следующие действия:

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

Как узнать номер проекта

Чтобы получить PROJECT_NUMBER_OR_ID облачного проекта Google Cloud:

  1. Перейдите на обзорную страницу проекта в Cloud Console.

  2. Если появится запрос, выберите проект.

  3. Номер проекта и идентификатор проекта появятся в разделе Информация о проекте на обзорном экране.

Как получить токен OAuth

Для аутентификации запрос к API должен содержать токен OAuth в заголовке Authorization. Подробнее об использовании OAuth…

Например, для создания токена можно использовать следующую команду gcloud:

gcloud auth application-default print-access-token

Вы можете включить команду gcloud непосредственно в заголовок Authorization в команде cURL, чтобы генерировать новый токен при каждом запросе, как показано в примере выше.

Вы также можете задать переменную среды, содержащую токен, а затем передать ее в запросе:

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