Partilhar via

Responder a avaliações 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 a(s) mesma(s) tarefa(s) usando o Partner Center.

Utilize a API de avaliações da Microsoft Store para responder programaticamente às avaliações da sua aplicação 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 Ative Directory (Azure AD) para autenticar as chamadas do seu aplicativo ou serviço.

As etapas a seguir descrevem o processo de ponta a ponta:

  1. Certifique-se de que preencheu 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 usá-lo 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 avaliações da Microsoft Store para responder às avaliações de forma programática, você pode, alternativamente, 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, certifique-se de ter concluído os seguintes pré-requisitos.

  • 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 corporativos da Microsoft, já tem o diretório do Azure AD. Caso contrário, você pode criar um novo Azure AD 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á-los 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 de 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 esta aplicação a função Gestor. 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. No ecrã seguinte, 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, consulte 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, deve primeiro obter um token de acesso do Azure AD que passa para o cabeçalho de Autorização 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 Service to Service Calls Using Client Credentials para enviar um HTTP POST para o https://login.microsoftonline.com/<tenant_id>/oauth2/token ponto de extremidade. Aqui está um pedido de amostra.

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 de recurso , deve especificar 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 avaliações da Microsoft Store contém vários métodos que você pode usar para determinar se tem permissão para responder a uma determinada avaliaçã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. Ligue para 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. Não é possível responder a avaliações enviadas por clientes que optaram por não receber respostas.
  3. Chame o método para enviar respostas às avaliações de aplicativos de forma programática.