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

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