Рабочий процесс учетной записи службы

В этом руководстве описано, как получить доступ к API Google Ads с помощью сервисных аккаунтов.

Сервисный аккаунт — это аккаунт, принадлежащий вашему приложению, а не отдельному конечному пользователю. Сервисные аккаунты используют протокол OAuth 2.0, который не требует авторизации человека, а использует файл ключа, доступ к которому имеет только ваше приложение.

Использование служебных учетных записей дает два ключевых преимущества:

• Авторизация доступа к аккаунтам Google Ads через API Google Ads осуществляется на этапе настройки с использованием функций авторизации и управления аккаунтами, предлагаемых пользовательским интерфейсом Google Ads. Это экономит усилия разработчиков, поскольку им не нужно создавать потоки OAuth 2.0 и разбираться со сложностями, связанными с взаимодействием с пользователем, хранением учетных данных пользователя и управлением токенами.

• Разрешение на доступ к аккаунтам Google Ads не привязано к индивидуальным учетным данным пользователя, что может быть полезно в случаях, когда предполагается, что такое разрешение сохранится даже в случае ухода сотрудника, первоначально предоставившего доступ, из команды или компании.

Настройка доступа к учетной записи

1. Для начала создайте учетную запись службы и укажите учетные данные .

   Загрузите ключ учетной записи службы в формате JSON и запишите идентификатор учетной записи службы и адрес электронной почты.

2. Войдите в свой аккаунт Google Ads как администратор. Перейдите в раздел «Администрирование» > «Доступ и безопасность» .

3. Нажмите кнопку «+» на вкладке «Пользователи» .

4. Введите адрес электронной почты служебной учетной записи в поле «Электронная почта» . Выберите соответствующий уровень доступа к учетной записи (обратите внимание, что служебные учетные записи не поддерживают уровень доступа только по электронной почте ) и нажмите кнопку «Добавить учетную запись» .

5. Учетной записи службы предоставлен доступ.

6. Необязательно: по умолчанию вы не можете предоставить администраторский доступ учетной записи службы. Следуйте принципу минимальных привилегий и предоставляйте администраторский доступ только в том случае, если этого требуют ваши вызовы API. Вы можете расширить доступ следующим образом:

   • В столбце «Уровень доступа» щелкните стрелку раскрывающегося списка рядом с уровнем доступа учетной записи службы.
   • Выберите «Администратор» из выпадающего списка.

Конфигурация клиентской библиотеки

Выберите вкладку, соответствующую вашему языку программирования, чтобы получить инструкции по настройке библиотеки клиентских приложений. Если ваша учетная запись службы получает доступ к клиентским аккаунтам через учетную запись менеджера Google Ads (MCC), также установите login-customer-id (или loginCustomerId ) равным 10-значному идентификатору клиента этой учетной записи менеджера без дефисов (см. Идентификатор клиента для входа ).

api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "JSON_KEY_FILE_PATH",
    // ...
};
GoogleAdsClient client = new GoogleAdsClient(config);

json_key_file_path: JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

[OAUTH2]
; For service account flow.
jsonKeyFilePath = "JSON_KEY_FILE_PATH"
scopes = "https://www.googleapis.com/auth/adwords"

c.keyfile = 'JSON_KEY_FILE_PATH'

jsonKeyFilePath=JSON_KEY_FILE_PATH

export GOOGLE_ADS_JSON_KEY_FILE_PATH=JSON_KEY_FILE_PATH

gcloud auth login --cred-file=JSON_KEY_FILE_PATH

gcloud auth \
  print-access-token \
  --scopes='https://www.googleapis.com/auth/adwords'

curl -i -X POST \
  https://googleads.googleapis.com/v25/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

{
  "query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}