Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Используйте API оборудования Майкрософт для программного запроса и создания отправки для аппаратных продуктов в учетной записи Центра партнеров вашей организации. Эти API полезны, если ваша учетная запись управляет множеством продуктов, и вы хотите автоматизировать и оптимизировать процесс отправки для этих ресурсов. Эти API используют идентификатор Microsoft Entra (Идентификатор Microsoft Entra) для проверки подлинности вызовов из приложения или службы.
Только учетные записи, принадлежащие программе Центра партнеров по оборудованию , могут использовать API панели управления оборудованием. Ниже приведен комплексный процесс использования API оборудования Майкрософт:
Выполните необходимые условия в следующем разделе.
Получите токен доступа Microsoft Entra ID перед вызовом метода в Microsoft Hardware API. После получения токена у вас есть 60 минут, чтобы использовать его в вызовах API подачи Microsoft Store до истечения срока действия токена. Когда срок действия токена истечет, вы можете создать новый.
Вызовите API оборудования Майкрософт.
Выполните необходимые условия для использования API оборудования Майкрософт
Прежде чем приступить к написанию кода для вызова API оборудования Майкрософт, необходимо выполнить следующие необходимые условия:
You (or your organization) must have a Microsoft Entra ID directory and you must have Global administrator permission for the directory. Если вы уже используете Microsoft 365 или другие бизнес-службы от Майкрософт, у вас уже есть каталог идентификатора Microsoft Entra. В противном случае можно создать новый идентификатор Microsoft Entra в Центре партнеров без дополнительной платы.
Если приложение Идентификатора Microsoft Entra еще не существует, необходимо создать один.
Необходимо связать приложение Идентификатора Microsoft Entra с учетной записью Центра партнеров и назначить ей роль руководителя.
Соберите идентификатор клиента приложения Microsoft Entra ID, идентификатор клиента и ключ. Не забудьте распечатать или скопировать эту информацию, так как вы не сможете получить доступ к ней еще раз после выхода страницы создания ключа.
Назначение соответствующих ролей оборудования приложению идентификатора Microsoft Entra
После выполнения предварительных требованийназначьте соответствующие роли, чтобы приложение Microsoft Entra ID могло создавать и управлять отправками и метками доставки.
From Partner Center, select the gear icon (near the upper right corner of the dashboard) and then select Developer settings. In the Settings menu, select Users.
On the Users page, select Microsoft Entra ID applications and the Microsoft Entra ID application that represents the app or service you use to access submissions for your Partner Center account.
On this page, under Roles, select Hardware.
Select Driver Submitter, Shipping Label owner, and if available, Shipping Label promoter. Дополнительные сведения об этих ролях
Получение маркера доступа идентификатора Microsoft Entra
Before you call any of the methods in the Microsoft Hardware API, you must first obtain a Microsoft Entra ID access token that you pass to the Authorization header of each method in the 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://manage.devcenter.microsoft.com
For the tenant_id value in the POST URI and the client_id and client_secret parameters, specify the tenant ID, client ID, and the key for your application that you retrieved from Partner Center in the previous section. For the resource parameter, you must specify https://manage.devcenter.microsoft.com.
После истечения срока действия маркера доступа его можно обновить, следуя инструкциям в разделе "Обновление маркеров доступа".
Использование API оборудования Майкрософт
После получения маркера доступа к идентификатору Microsoft Entra можно вызвать методы в API оборудования Майкрософт. API включает множество методов, сгруппированных в сценарии. Для создания или обновления отправки обычно вызывается несколько методов в API оборудования Майкрософт в определенном порядке. Сведения о каждом сценарии и синтаксисе каждого метода см. в статьях в следующей таблице.
| Scenario | Description |
|---|---|
| Drivers | Получение, создание и обновление драйверов, зарегистрированных в учетной записи Центра партнеров. Дополнительные сведения об этих методах см. в следующих статьях: |
Code sample
В следующем образце кода представлено комплексное предварительно разработанное решение, созданное командой Microsoft Surface и устройств.
More help
If you have questions about the Microsoft Store submission API or need assistance managing your submissions with this API, visit the support page and request help.