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

Для отправки запроса к API картографических наборов данных необходимо включить следующее:

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

  Примечание: Если вы используете служебную учетную запись для аутентификации, вы можете опустить заголовок X-Goog-User-Project . Дополнительную информацию о служебных учетных записях см. в разделе «Аутентификация в Google» .

• Токен 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. Перейдите на страницу «Обзор» проекта в консоли Cloud.

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

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

Получите токен OAuth

Примечание: Описанная ниже процедура генерации токена 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