Partilhar via


Responder a comentários usando os serviços da Loja

Importante

A API de revisões da Microsoft Store, conforme documentado neste tópico, não está atualmente em um estado de funcionamento. Em vez de usar as APIs, você pode realizar as mesmas tarefas usando o Partner Center.

Use a API de revisões da Microsoft Store para responder programaticamente às revisões do seu aplicativo na Loja. Essa API é especialmente útil para desenvolvedores que desejam responder em massa a muitas avaliações sem usar o Partner Center. Essa API usa o Azure Active Directory (Azure AD) para autenticar as chamadas do aplicativo ou serviço.

As etapas a seguir descrevem o processo completo:

  1. Certifique-se de ter concluído todos os pré-requisitos.
  2. Antes de chamar um método na API de revisões da Microsoft Store, obtenha um token de acesso do Azure AD. Depois de obter um token, você tem 60 minutos para usar esse token em chamadas para a API de revisões da Microsoft Store antes que o token expire. Depois que o token expirar, será possível gerar um novo.
  3. Chame a API de revisões da Microsoft Store.

Observação

Além de usar a API de revisões da Microsoft Store para responder programaticamente às avaliações, você também pode responder às revisões usando o Partner Center.

Etapa 1: Concluir os pré-requisitos para usar a API de revisões da Microsoft Store

Antes de começar a escrever código para chamar a API de revisões da Microsoft Store, verifique se você concluiu os pré-requisitos a seguir.

  • Você (ou sua organização) deve ter um diretório do Azure AD e você deve ter permissão de Administrador global para o diretório. Se já usa o Microsoft 365 ou outros serviços empresariais da Microsoft, você já tem o diretório do Azure AD. Caso contrário, crie um Azure AD na Central de Parceiros sem custo adicional.

  • Você deve associar um aplicativo do Azure AD à 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 Azure AD representa o aplicativo ou serviço do qual você deseja chamar a API de revisões da Microsoft Store. Você precisa da ID do locatário, da ID do cliente e da chave para obter um token de acesso do Azure AD que é passado para a API.

    Observação

    É necessário executar essa tarefa apenas uma vez. Depois de obter a ID do locatário, a ID do cliente e a chave, você poderá reutilizá-las sempre que precisar criar um novo token de acesso do Azure AD.

Para associar um aplicativo do Azure AD à sua conta do Partner Center e recuperar os valores necessários:

  1. Na Central de Parceiros, associe a conta da Central de Parceiros da sua organização ao diretório do Azure AD da sua organização.

  2. Em seguida, na página Usuários na seção Configurações da conta do Partner Center, adicione o aplicativo Azure AD que representa o aplicativo ou serviço que você usará para responder às avaliações. Lembre-se de atribuir esse aplicativo à função de Gerenciador. Se o aplicativo ainda não existir no diretório do Azure AD, crie um novo aplicativo do Azure AD na Central de Parceiros.

  3. Retorne à página Usuários, clique no nome do seu aplicativo do Azure AD para acessar as configurações do aplicativo e copie os valores de ID do Locatário e ID do Cliente.

  4. Clique em Adicionar nova chave. Na tela a seguir, copie o valor da Chave. Você não poderá acessar essas informações novamente depois de sair da página. Para saber mais, veja Gerenciar chaves de um aplicativo do Azure AD.

Etapa 2: obter um token de acesso do Azure AD

Antes de chamar qualquer um dos métodos na API de revisões da Microsoft Store, você deve primeiro obter um token de acesso do Azure AD que você passa para o cabeçalho Authorization de cada método na 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. Confira a seguir um exemplo de solicitação.

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

Para o valor tenant_id no POST URI e nos parâmetros client_id e client_secret, especifique a ID do locatário, a ID do cliente e a chave para o aplicativo recuperado do Partner Center na seção anterior. Para o parâmetro resource, especifique https://manage.devcenter.microsoft.com.

Depois que seu token de acesso expirar, você poderá atualizá-lo seguindo as instruções aqui.

Etapa 3: Chamar a API de revisões da Microsoft Store

Depois de ter um token de acesso do Azure AD, você estará pronto para chamar a API de revisões da Microsoft Store. Você deve passar o token de acesso para o cabeçalho Authorization de cada método.

A API de revisões da Microsoft Store contém vários métodos que você pode usar para determinar se você tem permissão para responder a uma determinada revisão e enviar respostas a uma ou mais avaliações. Siga este processo para usar esta API:

  1. Obtenha os IDs das avaliações às quais você deseja responder. As IDs de revisão estão disponíveis nos dados de resposta do método obter revisões de aplicativos na API de análise da Microsoft Store e no download offline do [Relatório de revisões](/windows/apps/publish/reviews-report).
  2. Chame o método obter informações de resposta para revisões do aplicativo para determinar se você tem permissão para responder às avaliações. Quando um cliente envia uma avaliação, ele pode optar por não receber respostas à avaliação. Não é possível responder a avaliações enviadas por clientes que optaram por não receber respostas de avaliação.
  3. Chame o método de envio de respostas às revisões do aplicativo para responder programaticamente às revisões.