API Search Ads 360 требует, чтобы во всех запросах для аутентификации указывался токен доступа OAuth 2.0 . Вы можете использовать любой стандартный рабочий процесс аутентификации OAuth 2.0, чтобы сгенерировать токен и передать его API Search Ads 360. Мы рекомендуем рабочий процесс, описанный ниже, поскольку он подходит для полностью автоматизированной загрузки конверсий и скачивания отчетов.
Альтернативы описанному ниже рабочему процессу см. в разделе Использование OAuth 2.0 для установленных приложений или Использование OAuth 2.0 для межсерверных приложений . Если вы используете альтернативный рабочий процесс, укажите следующее значение в качестве параметра scope
при запросе кода авторизации OAuth 2.0:
https://www.googleapis.com/auth/doubleclicksearch
Если вы следуете маршруту между серверами, добавьте сервисный аккаунт в качестве пользователя Поисковой рекламы 360.
Рекомендуемый рабочий процесс авторизации
- Перейдите в Google API Console и выберите свой проект.
Если вы еще не создали проект консоли API Google и учетные данные OAuth, следуйте инструкциям в разделе Создание проекта консоли API Google и учетных данных OAuth для вашего клиента .
Чтобы найти идентификатор и секрет клиента OAuth вашего проекта, выполните следующие действия:
- Откройте страницу учетных данных .
- В столбце Имя щелкните имя своего клиента OAuth.
- Идентификатор клиента и секрет указаны на странице.
- Откройте веб-браузер и войдите в Google , используя аккаунт Google, у которого есть разрешение на доступ к данным в Search Ads 360.
Это учетная запись Google, которую ваш API-клиент будет использовать для аутентификации в Поисковой рекламе 360. Если владелец учетной записи Google покидает вашу компанию и вы удаляете доступ к Поисковой рекламе 360 из учетной записи, вам нужно будет повторить этот рабочий процесс авторизации и указать другую учетную запись Google. .
- Получите токен обновления, запустив служебный скрипт Search Ads 360 следующим образом:
sa360Api.py --login
Сценарий проведет вас через процесс использования идентификатора и секрета клиента Oauth для получения токена обновления. Токен обновления действителен только для учетной записи Google, в которую вы вошли на предыдущем шаге.
В рамках этого процесса сценарий генерирует URL-адрес и предлагает вам перейти по этому URL-адресу в веб-браузере.
Когда браузер попросит вас разрешить клиенту OAuth доступ к данным Search Ads 360, убедитесь, что отображается аккаунт Google, в который вы вошли ранее. (Если вы вошли в несколько учетных записей Google, вам может быть представлена другая учетная запись.)
В конце процесса сценарий
sa360Api.py
выводит строку с разделителями-запятыми. Первое значение — это предоставленный вами идентификатор клиента, второе значение — предоставленный вами секрет клиента, а третье значение — токен обновления. В следующем примере токен обновления выделен полужирным шрифтом :
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef, 1/HIJklM01OPQR23NOP456rst890uvw
- Сохраните идентификатор клиента, секрет клиента и токен обновления во внутренней базе данных или в другом безопасном месте, доступном для вашего приложения.
Сохраните всю строку с разделителями-запятыми в удобном месте, если вы планируете использовать
sa360Api.py
для отправки примеров запросов JSON в API Search Ads 360. Вы будете передавать всю строку в качестве параметра при каждом вызове скрипта. - Добавьте в приложение код, который делает следующее:
- Используйте идентификатор клиента, секрет клиента и токен обновления, чтобы получить новый токен доступа OAuth 2.0.
- Отправляйте запросы к API Search Ads 360, используя новый токен доступа.
Если вы используете клиентские библиотеки, в следующем разделе Настройка приложения описывается, как добавить этот код авторизации в ваше приложение.
Если вы не используете одну из клиентских библиотек, см. раздел Использование OAuth 2.0 для установленных приложений , где приведены рекомендации по получению нового токена доступа.