Responder a avaliações usando os serviços da Loja

  • Artigo

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 a(s) mesma(s) tarefa(s) usando o Partner Center.

Use a API de avaliações da Microsoft Store para responder programaticamente às avaliações de 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 seu aplicativo ou serviço.

As etapas a seguir descrevem o processo completo:

  1. Certifique-se de ter preenchido 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, você poderá gerar um novo token.
  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ê pode responder às avaliaçõ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 deve ter permissão de administrador global para o diretório. Se você já usa o Microsoft 365 ou outros serviços comerciais da Microsoft, já tem o diretório do Azure AD. Caso contrário, você pode criar um novo AD do Azure no Partner Center 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 você passa para a API.

    Observação

    Você só precisa executar essa tarefa uma vez. Depois de ter 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. No Partner Center, associe a conta do Partner Center 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 do Azure AD que representa o aplicativo ou serviço que você usará para responder às avaliações. Certifique-se de atribuir a este aplicativo a função de gerente . Se o aplicativo ainda não existir no diretório do Azure AD, você poderá criar um novo aplicativo do Azure AD no Partner Center.

  3. Retorne à página Usuários, clique no nome do seu aplicativo do Azure AD para ir para 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 desta página. Para obter mais informações, confira Gerenciar chaves para 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. Depois de obter um token de acesso, você tem 60 minutos para usá-lo antes que ele expire. Depois que o token expirar, você poderá atualizá-lo para continuar a usá-lo em outras chamadas para a API.

Para obter o token de acesso, siga as instruções em Serviço para chamadas de serviço usando credenciais de cliente para enviar um HTTP POST para o https://login.microsoftonline.com/<tenant_id>/oauth2/token ponto de extremidade. 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://manage.devcenter.microsoft.com

Para o valor tenant_id no URI POST e os parâmetros client_id e client_secret, especifique a ID do locatário, a 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://manage.devcenter.microsoft.com.

Depois que o 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 get app reviews na API de análise da Microsoft Store e no download offline do [Relatório de avaliações](/windows/apps/publish/reviews-report).
  2. Chame o método get response info for app reviews 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. Você não pode responder a avaliações enviadas por clientes que optaram por não receber respostas de comentários.
  3. Chame o método de envio de respostas para revisões de aplicativos para responder programaticamente às avaliações.