Places API (новый) поддерживает использование OAuth 2.0 для аутентификации. Google поддерживает распространенные сценарии OAuth 2.0, например сценарии для веб-сервера.
В этом документе описывается, как передать токен OAuth в вызов Places API (новый) в вашей среде разработки . Инструкции по использованию OAuth в производственной среде см. в разделе Аутентификация в Google .
Прежде чем начать
Прежде чем вы начнете использовать Places API (новый), вам понадобится проект с платежным аккаунтом и включенным Places API (новый). Мы рекомендуем создать несколько владельцев проектов и администраторов по выставлению счетов, чтобы в вашей команде всегда был кто-то с этими ролями. Дополнительные сведения см. в разделе Настройка в Cloud Console .
О протоколе OAuth
Существует множество способов создания токенов доступа и управления ими с помощью OAuth в зависимости от вашей среды развертывания.
Например, система Google OAuth 2.0 поддерживает взаимодействие между серверами, например между вашим приложением и службой Google. Для этого сценария вам понадобится учетная запись службы, которая принадлежит вашему приложению, а не отдельному конечному пользователю. Ваше приложение вызывает API Google от имени учетной записи службы, поэтому пользователи не участвуют напрямую. Дополнительную информацию о методах аутентификации см. в разделе Аутентификация в Google .
Альтернативно вы можете использовать Places API (новый) как часть мобильного приложения для Android или iOS. Общие сведения об использовании OAuth с API-интерфейсом Places (новым), включая информацию об управлении токенами доступа для различных сред развертывания, см. в разделе Использование OAuth 2.0 для доступа к API Google .
Об областях действия OAuth
Чтобы использовать OAuth с API Places (новое), токену OAuth необходимо назначить область действия:
-
https://www.googleapis.com/auth/cloud-platform
Пример. Попробуйте вызовы REST API в вашей локальной среде разработки.
Если вы хотите попробовать Places API (новый) с использованием токена OAuth, но у вас нет настройки среды для создания токенов, вы можете использовать процедуру, описанную в этом разделе, для выполнения вызова.
В этом примере описывается, как использовать токен OAuth, предоставленный учетными данными приложения по умолчанию (ADC), для выполнения вызова. Информацию об использовании ADC для вызова API Google с помощью клиентских библиотек см. в разделе Аутентификация с использованием клиентских библиотек .
Предварительные условия
Прежде чем вы сможете выполнить запрос REST с помощью ADC, используйте Google Cloud CLI, чтобы предоставить учетные данные ADC:
- Если вы еще этого не сделали, создайте проект и включите оплату, выполнив действия, описанные в разделе «Настройка в Google Cloud Console» .
- Установите и инициализируйте CLI gcloud .
Запустите следующую команду
gcloud
на своем локальном компьютере, чтобы создать файл учетных данных:gcloud auth application-default login
- Отобразится экран входа в систему. После входа в систему ваши учетные данные сохраняются в локальном файле учетных данных, используемом ADC .
Дополнительные сведения см. в разделе «Локальная среда разработки» документации «Предоставление учетных данных для учетных данных приложения по умолчанию» .
Сделать REST-запрос
В этом примере вы передаете два заголовка запроса:
Передайте токен OAuth в заголовке
Authorization
, используя следующую команду для создания токена:gcloud auth application-default print-access-token
Возвращенный токен имеет область действия
https://www.googleapis.com/auth/cloud-platform.
- Передайте идентификатор или имя вашего проекта Google Cloud, для которого включена оплата, в заголовке
X-Goog-User-Project
. Дополнительные сведения см. в разделе Настройка в Cloud Console .
В следующем примере выполняется вызов Places API (нового) с использованием токена OAuth:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "X-Goog-User-Project: PROJECT_ID" \ -H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \ "https://places.googleapis.com/v1/places:searchText"
Поиск неисправностей
Если ваш запрос возвращает сообщение об ошибке о том, что учетные данные конечного пользователя не поддерживаются этим API, см. раздел «Учетные данные пользователя не работают» .