Для вызова API отчетов Search Ads 360 вам потребуются учетные данные приложения OAuth 2.0. Если вы выполняете вызовы API от имени управляющего аккаунта Search Ads 360, вам также необходимо указывать заголовок login-customer-id в каждом запросе. На этой странице описано, как установить эти значения, и документировано несколько дополнительных HTTP-заголовков, специфичных для API, которые отправляются и получаются при использовании интерфейса REST.
Учетные данные OAuth 2.0
API отчетов Search Ads 360 использует учетные данные приложения для идентификации и авторизации запросов API. Клиенты OAuth 2.0 могут быть настроены. Все вызовы API отчетов Search Ads 360 должны быть авторизованы через OAuth2. OAuth2 позволяет вашему клиентскому приложению Search Ads 360 Reporting API получать доступ к аккаунту пользователя Search Ads 360 без необходимости обработки или хранения данных для входа пользователя.
Если вы новичок в API Google, вы можете использовать oauth2l или OAuth 2.0 Playground , чтобы поэкспериментировать с учетными данными приложения и API отчетов Search Ads 360, прежде чем писать код для своего приложения. Вы также можете создать токен обновления OAuth, запустив предоставленный сценарий создания учетных данных пользователя .
Генерация новых токенов доступа
Получив идентификатор клиента , секрет клиента и токен обновления , вы можете сгенерировать новый токен доступа для использования в вызовах API с помощью инструмента командной строки curl :
curl \
--data "grant_type=refresh_token" \
--data "client_id=CLIENT_ID" \
--data "client_secret=CLIENT_SECRET" \
--data "refresh_token=REFRESH_TOKEN" \
https://www.googleapis.com/oauth2/v3/token
Затем вы используете токен доступа , возвращаемый запросом Curl, в HTTP-заголовке Authorization каждого вызова API к API отчетов Search Ads 360:
GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
Заголовки запросов
Войти в идентификатор клиента
Для вызовов API отчетов Search Ads 360, выполняемых менеджером к клиентскому аккаунту (то есть при входе в систему в качестве менеджера для выполнения вызовов API к одному из его клиентских аккаунтов), вам также необходимо указать HTTP-заголовок login-customer-id . Это значение представляет собой идентификатор клиента Search Ads 360 менеджера, выполняющего вызов API.
Включение этого заголовка эквивалентно выбору учетной записи в пользовательском интерфейсе Search Ads 360 после входа в систему или нажатия на изображение своего профиля в правом верхнем углу страницы. При указании идентификатора клиента обязательно удаляйте дефисы (—), например: 1234567890 , а не 123-456-7890 .
GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
Заголовки ответов
Следующие заголовки возвращаются в ответах HTTP от API.
Идентификатор запроса
request-id — это строка, которая однозначно идентифицирует запрос API. При отладке или устранении проблем с конкретными вызовами API request-id является важным идентификатором, который будет полезен при обращении в службу поддержки разработчиков Google.
request-id: 2a5Cj89VV7CNhya1DZjjrC