Этот раздел предназначен для продвинутых пользователей, которые уже знакомы со спецификацией OAuth 2.0 и знают, как использовать OAuth 2.0 с API Google .
Объем
Один токен доступа может предоставлять различные уровни доступа к нескольким API. Переменный параметр, называемый scope , управляет набором ресурсов и операций, которые разрешает токен доступа. При запросе токена доступа ваше приложение отправляет одно или несколько значений в параметре scope .
Область применения API Google Ads:
https://www.googleapis.com/auth/adwords
Оффлайн доступ
Клиентское приложение API Google Ads часто запрашивает офлайн-доступ. Например, вашему приложению может потребоваться выполнять пакетные задания, когда пользователь не находится в сети и не просматривает ваш сайт.
Чтобы запросить автономный доступ к веб-приложению, убедитесь, что параметр access_type установлен на offline . Дополнительную информацию можно найти в руководстве Google по OAuth2 .
Для настольного приложения автономный доступ включен по умолчанию — вам не нужно явно запрашивать его.
Заголовки запроса
заголовки gRPC
При использовании API gRPC включайте токен доступа в каждый запрос. Вы можете привязать Credential к Channel для использования во всех запросах на этом канале. Вы также можете отправлять индивидуальные учётные данные для каждого вызова. Руководство по авторизации gRPC содержит более подробную информацию об обработке авторизации.
Заголовки REST
При использовании REST API передайте токен доступа через HTTP-заголовок Authorization . Пример HTTP-запроса показан ниже:
# Returns the resource names of customers directly accessible by the user # authenticating the call. # # Variables: # API_VERSION, # DEVELOPER_TOKEN, # OAUTH2_ACCESS_TOKEN: # See https://developers.google.com/google-ads/api/rest/auth#request_headers # for details. # curl -f --request GET \ "https://googleads.googleapis.com/v${API_VERSION}/customers:listAccessibleCustomers" \ --header "Content-Type: application/json" \ --header "developer-token: ${DEVELOPER_TOKEN}" \ --header "Authorization: Bearer ${OAUTH2_ACCESS_TOKEN}" \