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
Если вы следуете по маршруту от сервера к серверу, добавьте сервисный аккаунт в качестве пользователя Search Ads 360.
Рекомендуемый процесс авторизации
- Перейдите в консоль Google API и выберите свой проект.
Если вы еще не создали проект консоли Google API и учетные данные OAuth, следуйте инструкциям в разделе Создание проекта консоли Google API и учетных данных OAuth для вашего клиента .
Чтобы найти идентификатор и секрет клиента OAuth вашего проекта, выполните следующие действия:
- Откройте страницу учетных данных .
- В столбце «Имя » щелкните имя вашего клиента OAuth.
- Идентификатор клиента и секретный код указаны на странице.
- Откройте веб-браузер и войдите в Google, используя учетную запись Google, у которой есть разрешение на доступ к данным в Search Ads 360.
Это учетная запись Google, которую ваш API-клиент будет использовать для аутентификации в Search Ads 360. Если владелец учетной записи Google покинет вашу компанию и вы удалите доступ к Search Ads 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 в Search Ads 360 API. Вы будете передавать всю строку в качестве параметра каждый раз, когда вызываете скрипт. - Добавьте в приложение код, который выполняет следующие действия:
- Используйте идентификатор клиента, секрет клиента и токен обновления, чтобы получить новый токен доступа OAuth 2.0.
- Отправляйте запросы к API Search Ads 360, используя новый токен доступа.
Если вы используете клиентские библиотеки, в следующем разделе «Настройка приложения» описывается, как добавить этот код авторизации в ваше приложение.
Если вы не используете ни одну из клиентских библиотек, ознакомьтесь с рекомендациями по получению нового токена доступа в разделе «Использование OAuth 2.0 для установленных приложений» .