Начать

Вы можете использовать API Agencies & Brands для создания отчетов, которые позволят получить представление об эффективности работы вашего агентского аккаунта.

Счета агентства

Аккаунт агентства представляет собой рекламное агентство, взаимодействующее с издателями Google Ad Manager. Идентификатор аккаунта вашего агентства можно найти в пользовательском интерфейсе агентства , войдя в свою учетную запись Google.

Настройка аутентификации

API Google используют протокол OAuth 2.0 для аутентификации и авторизации. Вот как настроить учетную запись службы для доступа к API агентств и брендов:

  1. Если вы еще этого не сделали, создайте проект Google Cloud , в котором будут храниться ваши учетные данные, используемые для доступа к API.

  2. Перейдите на страницу «Включенные API» в консоли Google Cloud . Выберите проект, который вы создали ранее.

  3. Вы видите список включенных API и сервисов. Для доступа к API «Агентства и бренды» необходимо его включить. Если он не включен, нажмите кнопку «+Включить API и сервисы» , найдите API «Агентства и бренды» , выберите его и нажмите «Включить» .

    Известна проблема, из-за которой API «Агентства и бренды» может быть недоступен в поле поиска консоли Google Cloud. В качестве альтернативы вы можете использовать Google Cloud CLI для включения API. После установки gcloud CLI вы можете включить API «Агентства и бренды» с помощью следующей команды:

    gcloud services enable agenciesandbrands.googleapis.com --project=CLOUD_PROJECT_ID

  4. В навигационном меню выберите «Учетные данные» .

  5. Нажмите кнопку «+Создать учетные данные» , и в появившемся меню выберите «Учетная запись службы» .

  6. Введите имя для учетной записи службы в поле «Имя» . Идентификатор учетной записи службы создается автоматически при создании. Это значение понадобится на следующем этапе. При желании введите описание. Нажмите «Создать и продолжить» .

  7. При желании настройте права доступа для учетной записи службы и нажмите «Продолжить» .

  8. При желании настройте пользователей или группы, которые смогут выполнять действия от имени учетной записи службы, и нажмите «Готово» .

  9. Ваша новая учетная запись службы отображается в разделе «Учетные записи служб» . Щелкните по идентификатору только что созданной учетной записи службы.

  10. Нажмите вкладку « Клавиши» .

  11. В меню «Добавить ключ» выберите «Создать новый ключ» .

  12. Выберите JSON в качестве типа ключа и нажмите «Создать» .

  13. Загрузите ключ в свою рабочую директорию. Дополнительную информацию о безопасном хранении ключа см. в разделе «Управление ключами учетных записей служб» . Ключ используется вашим приложением для выполнения вызовов API.

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

Области действия API

При прохождении процесса авторизации OAuth 2.0 для получения токена доступа, используемого для вызова API, необходимо указать область действия API:

https://www.googleapis.com/auth/agencies-and-brands

Следующие шаги