Обзор

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

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

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

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

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

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

    1. Воспользуйтесь поисковой строкой, чтобы найти Curation Partners API .
    2. Выберите Curation Partners API на странице результатов.
    3. Нажмите «Включить» .

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

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

  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/curation-partners .

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

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

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

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

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