Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use as APIs de Hardware da Microsoft para consultar e criar envios programaticamente para produtos de hardware na conta do Partner Center da sua organização. Essas APIs são úteis caso sua conta gerencie muitos produtos e você queira automatizar e otimizar o processo de envio desses ativos. Essas APIs usam o Microsoft Entra ID (Microsoft Entra ID) para autenticar as chamadas do seu aplicativo ou serviço.
Somente as contas que pertencem ao programa Hardware Partner Center podem usar as APIs do painel de hardware. Aqui está o processo de ponta a ponta do uso da API de Hardware da Microsoft:
Conclua os pré-requisitos na próxima seção.
Obtenha um token de acesso da ID do Microsoft Entra antes de chamar um método na API de Hardware da Microsoft. Depois de ter um token, você terá 60 minutos para usá-lo em chamadas para a API de envio da Microsoft Store antes que o token expire. Depois que o token expirar, você poderá gerar um novo.
Chame a API de Hardware da Microsoft.
Conclua os pré-requisitos para usar a API de Hardware da Microsoft
Antes de começar a escrever código para chamar a API de Hardware da Microsoft, você deve concluir estes pré-requisitos necessários:
You (or your organization) must have a Microsoft Entra ID directory and you must have Global administrator permission for the directory. Se já usa o Microsoft 365 ou outros serviços empresariais da Microsoft, você já tem o diretório do Microsoft Entra ID. Caso contrário, você pode criar uma nova ID do Microsoft Entra no Partner Center sem custo adicional.
Se um aplicativo do Microsoft Entra ID ainda não existir, você deverá criar um.
Você deve associar um aplicativo do Microsoft Entra ID à sua conta do Partner Center e atribuir a ele a função de gerente.
Colete a ID do locatário do aplicativo, a ID do cliente e a chave do Microsoft Entra ID. Imprima ou copie essas informações da chave, pois você não poderá acessá-las novamente depois de sair da página de criação de chaves.
Atribuir as funções de hardware apropriadas ao seu aplicativo do Microsoft Entra ID
Depois de concluir os pré-requisitos, atribua as funções apropriadas para que o aplicativo Microsoft Entra ID possa criar e gerenciar envios e etiquetas de envio.
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. Saiba mais sobre essas funções
Obter um token de acesso do Microsoft Entra ID
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. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar. Depois de expirar, é possível renovar o token para que você possa continuar a usá-lo em chamadas futuras para a API. Para obter o token de acesso, siga as instruções em Chamadas de Serviço para Serviço Usando Credenciais do Cliente para enviar um HTTP POST para o ponto de extremidade https://login.microsoftonline.com/<tenant_id>/oauth2/token. Aqui está uma solicitação de exemplo.
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.
Depois que o token de acesso expirar, você poderá atualizá-lo seguindo as instruções em Atualizar os tokens de acesso.
Usar a API de Hardware da Microsoft
Quando você tiver um token de acesso do Microsoft Entra ID, poderá chamar métodos na API de Hardware da Microsoft. A API inclui muitos métodos que são agrupados em cenários. Para criar ou atualizar envios, normalmente chamam-se vários métodos na API de Hardware da Microsoft em uma ordem específica. Para obter informações sobre cada cenário e a sintaxe de cada método, confira os artigos na tabela a seguir.
| Scenario | Description |
|---|---|
| Drivers | Obtenha, crie e atualize os drivers registrados em sua Conta do Partner Center. Para obter mais informações sobre esses métodos, confira os seguintes artigos: |
Code sample
O exemplo de código a seguir fornece uma solução predefinida de ponta a ponta completa criada pela equipe do Microsoft Surface and Devices:
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.