Partilhar via


Incorporação da API de envio do Partner Center

Use a API de envio do Partner Center para consultar, criar envios e publicar ofertas comerciais do mercado de forma programática. Esta API é útil se a sua conta gere muitas ofertas e pretende automatizar e otimizar o processo de submissão dessas ofertas.

Pré-requisitos da API

A API de submissões do Partner Center requer alguns ativos programáticos:

  • uma aplicação Microsoft Entra
  • Microsoft Entra: um token de acesso

Etapa 1: concluir os pré-requisitos para usar a API de envio do Partner Center

Antes de começar a escrever código para chamar a API de envio do Partner Center, verifique se você concluiu os pré-requisitos a seguir.

  • Você (ou sua organização) deve ter um diretório do Microsoft Entra e deve ter permissão de de administrador global para o diretório. Se você já usa o Microsoft 365 ou outros serviços empresariais da Microsoft, você já tem o diretório Microsoft Entra. Caso contrário, você pode criar um novo de ID do Microsoft Entra no Partner Center sem custo adicional.
  • Você deve associar um de aplicativo Microsoft Entra à sua conta do Partner Center e obter sua ID de locatário, ID de cliente e chave. Você precisa deles para obter o token de acesso do Microsoft Entra que irá usar nas chamadas para a API de submissão da Microsoft Store.

Associar um aplicativo Microsoft Entra à sua conta do Partner Center

Para usar a API de envio do Partner Center, você deve associar um aplicativo Microsoft Entra à sua conta do Partner Center, recuperar a ID do locatário e a ID do cliente para o aplicativo e gerar uma chave. O aplicativo Microsoft Entra representa o aplicativo ou serviço do qual você deseja chamar a API de envio do Partner Center. Você precisa da ID do locatário, da ID do cliente e da chave para obter um token de acesso do Microsoft Entra para passar para a API.

Observação

Você só precisa executar essa tarefa uma vez. Depois de ter o ID do locatário, o ID do cliente e a chave, você pode reutilizá-los sempre que precisar criar um novo token de acesso do Microsoft Entra.

  1. No Partner Center, associe a conta do Partner Center da sua organização () ao diretório Microsoft Entra da sua organização ().

  2. Na página Usuários na secção Configurações da Conta do Partner Center, adicione o aplicativo Microsoft Entra que representa o aplicativo ou serviço que irá usar para aceder às submissões para a sua conta do Partner Center. Certifique-se de atribuir a esta aplicação a função Gestor. Se o aplicativo ainda não existir no diretório do Microsoft Entra, crie um novo aplicativo Microsoft Entra no Partner Center.

  3. Volte para a página Utilizadores, selecione o nome da sua aplicação Microsoft Entra para ir para as definições da aplicação e copie os valores de ID do Locatário e de ID do Cliente .

  4. Selecione Adicionar nova chave. Na tela seguinte, copie o valor Key. Você não poderá acessar essas informações novamente depois de sair desta página. Para obter mais informações, consulte Gerenciar chaves para um aplicativo Microsoft Entra.

Etapa 2: Obter um token de acesso do Microsoft Entra

Antes de chamar qualquer um dos métodos na API de envio do Partner Center, deve primeiro obter um token de acesso do Microsoft Entra para passar para o cabeçalho de Autorização do de cada método na API. Um token de acesso expira 60 minutos após a emissão. Depois disso, você pode atualizá-lo para poder usá-lo em futuras chamadas para a API.

Para obter o token de acesso, siga as instruções em Service to Service Calls Using Client Credentials para enviar um HTTP POST ao endpoint https://login.microsoftonline.com/<tenant_id>/oauth2/token. Aqui está um pedido 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://api.partner.microsoft.com

Para o valor tenant_id no URI POST e os parâmetros client_id e client_secret, especifique o ID do locatário, o ID do cliente e a chave do aplicativo que você recuperou do Partner Center na seção anterior. Para o parâmetro resource, você deve especificar https://api.partner.microsoft.com.

Etapa 3: Usar a API de envio do Partner Center

Depois de ter um token de acesso do Microsoft Entra, chame os métodos na API de envio do Partner Center. Para criar ou atualizar envios, normalmente você chama vários métodos na API de envio do Partner Center em uma ordem específica. Para obter informações sobre cada cenário e a sintaxe de cada método, consulte o Ingestion API Swagger.

  • Comece a usar a API de envio do Partner Center conforme descrito acima