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


Процесс подачи заявок через API Центра партнеров

Используйте API Центра партнеров для выполнения программных запросов, создания заявок и публикации предложений на коммерческой платформе. Этот API полезен, если ваша учетная запись управляет множеством предложений, и вы хотите автоматизировать и оптимизировать процесс отправки для этих предложений.

Предварительные требования API

API отправки Центра партнеров требует нескольких программных ресурсов:

  • приложение Microsoft Entra
  • токен доступа Microsoft Entra

Шаг 1. Завершите выполнение требований для использования API отправки в Центре партнеров.

Перед тем как приступить к написанию кода для вызова API отправки Partner Center, убедитесь, что выполнены следующие требования.

  • У вас (или вашей организации) должен быть каталог Microsoft Entra. Если вы уже используете Microsoft 365 или другие бизнес-службы от Майкрософт, у вас уже есть каталог Microsoft Entra. В противном случае вы можете создать новый идентификатор Microsoft Entra ID в Центре партнеров без дополнительной платы.
  • Необходимо связать приложение Microsoft Entra с учетной записью Партнёрского центра и получить ваш идентификатор клиента, идентификатор арендатора и ключ. Вам необходимо получить токен доступа Microsoft Entra, который вы будете использовать для вызовов API отправки в Microsoft Store.

Связывание приложения Microsoft Entra с учетной записью Центра партнеров

Чтобы использовать API отправки Центра партнеров, необходимо связать приложение Microsoft Entra с учетной записью Центра партнеров, получить идентификатор арендатора и идентификатор клиента для приложения и создать ключ. Приложение Microsoft Entra представляет приложение или службу, из которой вы хотите вызвать API отправки Центра партнеров. Вам нужен идентификатор клиента, идентификатор арендатора и ключ для получения токена доступа Microsoft Entra для передачи в API.

Заметка

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

  1. В Центре партнеров свяжите учетную запись Центра партнеров вашей организации с директорией Microsoft Entra вашей организации.

  2. На странице пользователей в разделе параметров учетной записи Центра партнеров добавьте приложение Microsoft Entra, представляющее приложение или службу, которое будет использоваться для доступа к заявкам на вашей учетной записи Центра партнеров. Убедитесь, что вы назначите этому приложению роль диспетчера. Если приложение еще не существует в каталоге Microsoft Entra, создать новое приложение Microsoft Entra в Центре партнеров.

  3. Вернитесь на страницу пользователей , выберите имя приложения Microsoft Entra, чтобы перейти к параметрам приложения, а также скопируйте идентификатор клиента и идентификатор клиента .

  4. Выберите Добавить новый ключ. На следующем экране скопируйте значение ключа. После выхода из этой страницы вы не сможете получить доступ к этой информации еще раз. Дополнительные сведения см. в разделе Управление ключами для приложения Microsoft Entra.

Шаг 2. Получение токена доступа Microsoft Entra

Перед вызовом любого из методов в API отправок Центра партнеров необходимо сначала получить токен доступа Microsoft Entra для передачи в заголовок авторизации каждого метода в API. Срок действия маркера доступа истекает через 60 минут после выдачи. После этого его можно обновить, чтобы использовать его в будущих вызовах API.

Чтобы получить токен доступа, следуйте инструкциям в разделе Вызовы от службы к службе с использованием клиентских учетных данных, чтобы отправить HTTP POST на конечную точку https://login.microsoftonline.com/<tenant_id>/oauth2/token. Ниже приведен пример запроса:

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource= https://api.partner.microsoft.com

Для значения tenant_id в URI POST, а также для параметров client_id и client_secret, укажите идентификатор клиента, ключ клиента и ключ приложения для вашего приложения, которые вы получили в Центре партнеров в предыдущем разделе. Для параметра ресурса необходимо указать https://api.partner.microsoft.com.

Шаг 3. Используйте API отправки в Центре партнеров

После того как у вас будет токен доступа Microsoft Entra, вызовите методы в API отправки Партнерского центра. Для создания или обновления публикаций в Центре партнеров обычно следует вызывать несколько методов API отправки в определенном порядке. Сведения о каждом сценарии и синтаксисе каждого метода см. в API поглощения Swagger.

  • Начните использовать API для отправки в Центре партнеров, как описано выше.