Обзор

Вы можете создавать и управлять сегментами данных, используя API авторизованной торговой площадки покупателей , который предоставляет ресурс curators.dataSegments . Это REST API с сгенерированными клиентскими библиотеками , которые вы можете использовать для своей интеграции.

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

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

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

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

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

    1. Вы будете перенаправлены на страницу с полем поиска. Найдите «API авторизованной торговой площадки покупателей» .
    2. На странице результатов выберите Authorized Buyers Marketplace API .
    3. Нажмите «Включить» .

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

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

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

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

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

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

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

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

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

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

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

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

При прохождении процедуры OAuth 2.0 для получения токена доступа, используемого для вызова API, необходимо указать API, к которым можно получить доступ с помощью этого токена. Для API Authorized Buyers Marketplace эта область действия — https://www.googleapis.com/auth/authorized-buyers-marketplace .

Как отличить сегменты данных в API от данных, обрабатываемых в режиме реального времени

В Marketplace API сегменты данных идентифицируются с помощью имени ресурса, специфичного для API, например:

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

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

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