Obter informações de resposta para análises
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.
Se você quiser responder programaticamente a uma avaliação do cliente sobre seu aplicativo, poderá usar esse método na API de revisões da Microsoft Store para determinar primeiro se você tem permissão para responder à revisão. Não é possível responder a avaliações enviadas por clientes que optaram por não receber respostas de avaliação. Depois de confirmar que você pode responder à revisão, você pode usar o método de envio de respostas às revisões do aplicativo para respondê-la programaticamente.
Pré-requisitos
Para usar este método, primeiro você precisa fazer o seguinte:
- Se você ainda não fez isso, conclua todos os pré-requisitos da API de análise da Microsoft Store.
- Obtenha um token de acesso do Azure AD a ser usado no cabeçalho da solicitação para esse método. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar. Depois que o token expirar, você poderá obter um novo.
- Obtenha o ID da avaliação que você deseja verificar para determinar se você pode responder a ela. 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.
Solicitar
Sintaxe da solicitação
| Método | URI da solicitação |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/reviews/{reviewId}/apps/{applicationId}/responses/info |
Cabeçalho da solicitação
| Cabeçalho | Tipo | Descrição |
|---|---|---|
| Autorização | string | Obrigatório. O token de acesso do Azure AD no Token<de portador> do formulário. |
Parâmetros da solicitação
| Parâmetro | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| applicationId | string | A ID da Loja do aplicativo que contém a revisão para a qual você deseja determinar se pode responder. O ID da Store está disponível na página de identidade do aplicativo na Central de Parceiros. Um exemplo de ID da Store é 9WZDNCRFJ3Q8. | Sim |
| ID da revisão | string | A ID da revisão à qual você deseja responder (este é um GUID). 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. Se você omitir esse parâmetro, o corpo da resposta para esse método indicará se você tem permissões para responder a quaisquer revisões do aplicativo especificado. |
Não |
Exemplo de solicitação
Veja exemplos a seguir de como usar esse método para determinar se você pode responder a uma determinada avaliação.
GET https://manage.devcenter.microsoft.com/v1.0/my/reviews/6be543ff-1c9c-4534-aced-af8b4fbe0316/apps/9WZDNCRFJ3Q8/responses/info HTTP/1.1
Authorization: Bearer <your access token>
Resposta
Corpo da resposta
| Valor | Tipo | Descrição |
|------------|--------|-----------------------| | Pode responder | Booleano | O valor true indica que você pode responder à avaliação especificada ou que tem permissões para responder a qualquer avaliação do aplicativo especificado. Caso contrário, esse valor será false. | | DefaultSupportEmail | cadeia de caracteres | O endereço de email de suporte do seu aplicativo, conforme especificado na listagem da Loja do seu aplicativo. Se você não especificou um endereço de e-mail de suporte, esse campo estará vazio. |
Exemplo de resposta
Veja a seguir um exemplo de corpo de resposta JSON para essa solicitação.
{
"CanRespond": true,
"DefaultSupportEmail": "support@contoso.com"
}