Потоки рабочего стола OAuth и веб-приложений

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

Создание учетных данных OAuth2 для одной учетной записи

Самый простой способ совершать звонки в аккаунты Google Ads API — это

  1. Свяжите все аккаунты, к которым вы хотите выполнять вызовы API, с одним управляющим аккаунтом Google Реклама .

  2. Используйте пример GenerateUserCredentials для создания учетных данных OAuth2 для пользователя с доступом к учетной записи менеджера.

  3. Используйте учетные данные OAuth2 для совершения вызовов во все аккаунты, которыми вам нужно управлять с помощью Google Ads API.

Эти шаги необходимо выполнить только один раз, если только вы не отзовете, не удалите или не захотите изменить разрешенные области действия для своих учетных данных OAuth2.

Шаг 1. Создайте учетные данные OAuth2.

  1. Следуйте инструкциям по настройке проекта Google API Console для Google Ads API .

  2. Запишите идентификатор клиента и секрет , а затем вернитесь на эту страницу.

Шаг 2. Настройте клиентскую библиотеку.

  1. В терминале запустите пример GenerateUserCredentials , который запрашивает ваш идентификатор и секрет клиента OAuth2.

    Это интерактивный пример, который потребует от вас ввода .

    dotnet run GenerateUserCredentials.csproj
    
  2. В примере вам будет предложено указать идентификатор клиента OAuth2 и его секрет . Укажите детали из шага 1.

  3. В примере URL автоматически открывается в браузере. Если вы не вошли в сеанс браузера, веб-страница предложит вам войти в учетную запись Google. Если вы уже вошли в систему, он пропустит запрос на вход и перенаправит вас на URL-адрес, где вам будет предложено авторизовать приложение для доступа к вашей учетной записи Google Реклама от вашего имени.

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

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

    Ваш токен обновления получен. Проверьте вывод консоли для получения дальнейших инструкций.

  5. Вернитесь к консоли, где вы запускали пример. Пример должен быть завершен и отображать ваш токен обновления и некоторые инструкции, за которыми следуют свойства, необходимые для настройки клиентской библиотеки:

    Copy the following content into your App.config file.
    
    <add key = 'OAuth2Mode' value = 'APPLICATION' />
    <add key = 'OAuth2ClientId' value = '******' />
    <add key = 'OAuth2ClientSecret' value = '******' />
    <add key = 'OAuth2RefreshToken' value = '******' />
    
    Make sure you also set the LOGIN_CUSTOMER_ID header. See
    https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration#google_ads_api_settings
    to learn more.
    
    <add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />
    
    See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration
    for alternate configuration options.
    

Создание учетных данных OAuth2 для интерактивных приложений

Если вы заранее не знаете аккаунт Google Рекламы, к которому нужно выполнять вызовы API, вы можете найти его во время выполнения, используя учетные данные пользователя, вошедшего в систему для сеанса. См. AuthenticateInAspNetCoreApplication для примера, где текущий вошедший пользователь проходит проверку подлинности, а учетные данные OAuth2 получаются во время выполнения.