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

Чтобы отправить запрос к 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. Перейдите на страницу обзора проекта в облачной консоли.

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