Enviar respostas às críticas
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 esse método na API de revisões da Microsoft Store para responder programaticamente às revisões do seu aplicativo. Ao chamar esse método, você deve especificar as IDs das avaliações às quais 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.
Quando um cliente envia uma avaliação, ele pode optar por não receber respostas à avaliação. Se você tentar responder a uma avaliação para a qual o cliente optou por não receber respostas, o corpo da resposta desse método indicará que a tentativa de resposta não foi bem-sucedida. Antes de chamar esse método, você pode, opcionalmente, determinar se tem permissão para responder a uma determinada revisão usando o método obter informações de resposta para revisões do aplicativo.
Observação
Além de usar esse método para responder programaticamente às revisões, você também pode responder às revisões usando o Partner Center.
Pré-requisitos
Para usar este método, primeiro você precisa fazer o seguinte:
- Se você ainda não tiver feito isso, conclua todos os pré-requisitos para a API de revisões 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 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.
Solicitar
Sintaxe da solicitação
| Método | URI da solicitação |
|---|---|
| POST | https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses |
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
Esse método não tem parâmetros de solicitação.
Corpo da solicitação
O corpo da solicitação tem os seguintes valores.
| Valor | Type | Descrição |
|---|---|---|
| Respostas | matriz | Uma matriz de objetos que contém os dados de resposta que você deseja enviar. Para obter mais informações sobre os dados em cada objeto, consulte a tabela a seguir. |
Cada objeto na matriz Responses contém os valores a seguir.
| Valor | Type | Descrição | Obrigatório |
|---|---|---|---|
| IDdoAplicativo | string | A ID da Loja do aplicativo com a avaliação à qual você deseja responder. A ID da Loja está disponível na página Identidade do aplicativo do Partner Center. Um exemplo de ID da Store é 9WZDNCRFJ3Q8. | Sim |
| ReviewId | 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. | Sim |
| Texto de resposta | string | A resposta que você deseja enviar. Sua resposta deve seguir estas diretrizes. | Sim |
| SuporteE-mail | string | O endereço de email de suporte do seu aplicativo, que o cliente pode usar para entrar em contato diretamente com você. Este deve ser um endereço de e-mail válido. | Sim |
| IsPublic | Booliano | Se você especificar true, sua resposta será exibida na listagem da Loja do seu aplicativo, diretamente abaixo da avaliação do cliente, e ficará visível para todos os clientes. Se você especificar false e o usuário não tiver optado por não receber respostas por email, sua resposta será enviada ao cliente por email e não ficará visível para outros clientes na listagem da Loja do seu aplicativo. Se você especificar false e o usuário tiver optado por não receber respostas por e-mail, um erro será retornado. | Sim |
Exemplo de solicitação
O exemplo a seguir demonstra como usar esse método para enviar respostas a várias revisões.
POST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
"Responses": [
{
"ApplicationId": "9WZDNCRFJ3Q8",
"ReviewId": "6be543ff-1c9c-4534-aced-af8b4fbe0316",
"ResponseText": "Thank you for pointing out this bug. I fixed it and published an update, you should have the fix soon",
"SupportEmail": "support@contoso.com",
"IsPublic": true
},
{
"ApplicationId": "9NBLGGH1RP08",
"ReviewId": "80c9671a-96c2-4278-bcbc-be0ce5a32a7c",
"ResponseText": "Thank you for submitting your review. Can you tell more about what you were doing in the app when it froze? Thanks very much for your help.",
"SupportEmail": "support@contoso.com",
"IsPublic": false
}
]
}
Resposta
Corpo da resposta
| Valor | Type | Description |
|---|---|---|
| Resultado | matriz | Uma matriz de objetos que contém dados sobre cada resposta enviada. Para obter mais informações sobre os dados em cada objeto, consulte a tabela a seguir. |
Cada objeto na matriz Result contém os valores a seguir.
| Valor | Type | Descrição |
|---|---|---|
| IDdoAplicativo | string | O ID da loja do aplicativo com a avaliação à qual você respondeu. Um exemplo de ID da Store é 9WZDNCRFJ3Q8. |
| ReviewId | string | O ID da avaliação à qual você respondeu. Este é um GUID. |
| Bem-sucedidas | string | O valor true indica que sua resposta foi enviada com êxito. O valor false indica que sua resposta não foi bem-sucedida. |
| Razão da falha | string | Se Successful for false, esse valor conterá um motivo para a falha. Se Successful for true, esse valor estará vazio. |
Exemplo de resposta
Veja a seguir um exemplo de corpo de resposta JSON para essa solicitação.
{
"Result": [
{
"ApplicationId": "9WZDNCRFJ3Q8",
"ReviewId": "6be543ff-1c9c-4534-aced-af8b4fbe0316",
"Successful": "true",
"FailureReason": ""
},
{
"ApplicationId": "9NBLGGH1RP08",
"ReviewId": "80c9671a-96c2-4278-bcbc-be0ce5a32a7c",
"Successful": "false",
"FailureReason": "No Permission"
}
]
}