Поделиться через

Справочник по API портала Cloud Partner

Замечание

API портала Cloud Partner интегрированы и будут продолжать работать в Центре партнеров. Переход вводит небольшие изменения. Ознакомьтесь с изменениями в API CPP , перечисленными в этом документе, чтобы убедиться, что ваш код продолжает работать после перехода в Центр партнеров. API CPP следует использовать только для существующих продуктов, которые уже были интегрированы перед переходом в Центр партнеров; новые продукты должны использовать API отправки Центра партнеров.

REST API Cloud Partner Portal позволяют программно извлекать рабочие нагрузки, предложения и профили издателей и управлять ими. API-интерфейсы используют управление доступом на основе ролей Azure (Azure RBAC) для обеспечения правильных разрешений во время обработки.

В этом справочнике содержатся технические сведения о REST API портала Cloud Partner Portal. Примеры полезных данных в этом документе приведены только для справки и могут изменяться по мере добавления новых функций.

Предварительные требования и рекомендации

Прежде чем использовать API, вам следует ознакомиться со следующими вопросами:

Изменения в API CPP после миграции в Центр партнеров

API Изменить описание Воздействие
POST Публикация, GoLive, Отмена Для перенесенных офферов заголовок ответа имеет другой формат, но продолжает работать в том же режиме, обозначая относительный путь для получения статуса операции. При отправке любого из соответствующих POST-запросов для оффера, заголовок Location имеет один из двух форматов в зависимости от статуса миграции оффера:
  • Неперенесенные предложения
    /api/operations/{PublisherId}${offerId}$2$preview?api-version=2017-10-31
  • Перенесенные офферы
    /api/publishers/{PublisherId}/offers/{offereId}/operations/408a4835-0000-1000-0000-000000000000?api-version=2017-10-31
Операция с оснасткой на землю Для типов офферов, которые ранее поддерживали поле 'notification-email' в ответе, это поле будет устаревшим и больше не будет возвращаться для перенесенных офферов. Для перенесенных офферов мы больше не будем отправлять уведомления на список email, указанный в запросах. Вместо этого служба API согласуется с процессом отправки уведомлений по электронной почте в Центре партнеров. В частности, уведомления будут отправляться на адрес электронной почты, указанный в разделе Контактные данные продавца в настройках вашей учетной записи в Центре партнеров, чтобы уведомить вас о ходе операции.

Проверьте адрес электронной почты, указанный в разделе Контактные данные продавца параметров учетной записи в Центре партнеров, чтобы убедиться, что для уведомлений указан правильный адрес электронной почты.

Стандартные задачи

В этом справочнике подробно описаны API для выполнения следующих распространенных задач.

Предложения

Операции

Публикация приложения

Другие задачи

Устранение неполадок

Версии и обновления API

Обновление Что изменилось?
12-2022 Общедоступный API CPP (версия 2017-10-31) теперь обновлен для захвата clientId и clientSecret для соединителя Marketo при настройке потенциальных клиентов. Во время настройки лида вам не нужно указывать поле serverId в дальнейшем. Это обновление API не включает в себя никаких обновлений версий или критических изменений.