Обзор

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

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

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

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

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

    1. Вы перенаправлены на страницу с полем поиска. Найдите API авторизованной торговой площадки .
    2. На странице результатов выберите API авторизованной торговой площадки покупателей .
    3. Нажмите «Включить» .
  4. В навигационном меню выберите Учетные данные .
  5. Нажмите +Создать учетные данные и в раскрывающемся меню выберите Учетная запись службы .
  6. Введите имя для учётной записи службы. Идентификатор учётной записи службы создаётся автоматически при её создании — запишите это значение, так как оно понадобится позже на шаге 14. При необходимости введите описание. Нажмите «Создать и продолжить» .
  7. При необходимости настройте разрешения для учетной записи службы и нажмите Продолжить .
  8. При необходимости настройте пользователей или группы, которые могут выполнять действия от имени учетной записи службы, и нажмите Готово .
  9. Ваша новая учётная запись службы указана в разделе «Учётные записи служб» . Найдите и нажмите на идентификатор только что созданной учётной записи службы.
  10. Откройте вкладку «Ключи» .
  11. В раскрывающемся меню Добавить ключ выберите Создать новый ключ .
  12. Выберите JSON в качестве типа ключа и нажмите Создать .
  13. Загрузите ключ в свой рабочий каталог. Подробнее о безопасном хранении ключа см. в статье Управление ключами учётной записи службы . Ключ используется вашим приложением для выполнения вызовов API.
  14. Сообщите идентификатор учетной записи службы своему техническому менеджеру по работе с клиентами, чтобы связать учетную запись службы с вашей учетной записью.

Области API

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

Как определить сегменты данных в API и как курировать данные в реальном времени

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

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

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

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