Потоки OAuth для настольных компьютеров и веб-приложений

В этом руководстве рассказывается, как настроить OAuth 2.0 для доступа к API, используя ваши собственные учетные данные и поток рабочего стола или веб-поток . Эти шаги необходимо выполнить только один раз, если только вы не отзовете, не удалите или не захотите изменить разрешенные области для своих учетных данных OAuth 2.0.

Создайте учетные данные OAuth 2.0.

  1. Следуйте инструкциям, чтобы настроить проект консоли Google API для Google Ads API .

  2. Загрузите файл JSON клиента, сначала щелкнув значок «Загрузить клиент OAuth» , а затем кнопку «ЗАГРУЗИТЬ JSON» на следующем экране.

    Сохраните файл в своем домашнем каталоге, чтобы теперь у вас был локальный файл ~/client_secret_XXX.apps.googleusercontent.com.json (где XXX — это значения, специфичные для вашего проекта). Мы будем использовать этот файл на следующем шаге для запуска примера кода.

Настройте клиентскую библиотеку

  1. В терминале запустите пример кода GenerateUserCredentials . Используйте флаги командной строки, чтобы передать загруженный вами JSON-файл OAuth 2.0.

    Вы можете использовать следующую команду для запуска примера кода из командной строки с использованием Gradle:
    ./gradlew --console=plain --quiet runExample \
          --example="authentication.GenerateUserCredentials \
          --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
        
  2. В этом примере кода вам будет предложено посетить URL-адрес, по которому вы должны разрешить приложению доступ к вашей учетной записи Google Рекламы от вашего имени.

    Paste this URL in your browser:
    https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
        

    Перейдите по URL-адресу в приватном сеансе браузера или в окне инкогнито. Войдите в учетную запись Google, которую вы используете для доступа к Google Рекламе. Обычно это адрес электронной почты для входа в управляющий аккаунт Google Рекламы, который содержит все аккаунты, которыми вам нужно управлять в рамках его иерархии аккаунтов. Нажмите «Продолжить» на экране согласия OAuth 2.0.

    Экран согласия OAuth 2.0

    Вы попадете на страницу с сообщением о том, что авторизация прошла успешно.

    Authorization code was successfully retrieved.
    
    Check the console output from `GenerateUserCredentials` for further instructions.
        
  3. Вернитесь в консоль, где вы запускаете пример кода. Вы увидите, что пример кода завершен и отображает токен обновления и некоторые инструкции, за которыми следуют инструкции, которым необходимо следовать для настройки клиентской библиотеки:

        #Mon Apr 18 09:07:51 EDT 2022
        api.googleads.refreshToken=1/Yw.........................................
        api.googleads.clientId=...........-...............apps.googleusercontent.com
        api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
        api.googleads.clientSecret=........................
        
  4. Скопируйте строки из комментария к дате # в конец вывода в ads.properties .

    Замените INSERT_DEVELOPER_TOKEN_HERE своим токеном разработчика.

    Для упрощения настройки поместите ads.properties в свой домашний каталог.