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

Чтобы сделать любой запрос к API наборов данных Карт, необходимо включить:

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

  • Токен OAuth в заголовке Authorization запроса. Подробнее об использовании OAuth с API наборов данных Карт см. в разделе Использование OAuth .

  • Номер или идентификатор проекта 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. Перейдите на страницу обзора проекта в консоли облака.

  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