Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте 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.
В Центре партнеров свяжите учетную запись Центра партнеров вашей организации с директорией Microsoft Entra вашей организации.
На странице пользователей в разделе параметров учетной записи Центра партнеров добавьте приложение Microsoft Entra, представляющее приложение или службу, которое будет использоваться для доступа к заявкам на вашей учетной записи Центра партнеров. Убедитесь, что вы назначите этому приложению роль диспетчера. Если приложение еще не существует в каталоге Microsoft Entra, создать новое приложение Microsoft Entra в Центре партнеров.
Вернитесь на страницу пользователей
, выберите имя приложения Microsoft Entra, чтобы перейти к параметрам приложения, а также скопируйте идентификатор клиента и идентификатор клиента . Выберите Добавить новый ключ. На следующем экране скопируйте значение ключа. После выхода из этой страницы вы не сможете получить доступ к этой информации еще раз. Дополнительные сведения см. в разделе Управление ключами для приложения 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 для отправки в Центре партнеров, как описано выше.