Obter informações de resposta para análisesGet response info for reviews

Se você quiser responder de forma programática a uma análise feita pelo cliente ao seu aplicativo, você pode usar este método na API de análises da Microsoft Store para determinar primeiro se você tem permissão para responder à análise.If you want to programmatically respond to a customer review of your app, you can use this method in the Microsoft Store reviews API to first determine whether you have permission to respond to the review. Você não poderá responder às análises enviadas por clientes que optaram por não receber respostas a análises.You cannot respond to reviews submitted by customers who have chosen not to receive review responses. Depois de confirmar que você pode responder à análise, você pode usar o método enviar respostas às análises do aplicativo para responder de forma programática à ela.After you confirm that you can respond to the review, you can then use the submit responses to app reviews method to programmatically respond to it.

Pré-requisitosPrerequisites

Para usar este método, primeiro você precisa do seguinte:To use this method, you need to first do the following:

  • Se você não tiver feito isso, conclua todos os pré-requisitos para a API de análise da Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • Obtenha um token de acesso do Azure AD a ser usado no cabeçalho da solicitação para este método.Obtain an Azure AD access token to use in the request header for this method. Depois de obter um token de acesso, você terá 60 minutos para usá-lo antes que ele expire.After you obtain an access token, you have 60 minutes to use it before it expires. Depois que o token expirar, você poderá obter um novo.After the token expires, you can obtain a new one.
  • Obtenha a ID da análise que você deseja verificar para determinar se você pode responder a ela.Get the ID of the review you want to check to determine whether you can respond to it. As IDs de revisão estão disponíveis nos dados de resposta do método obter avaliações de app na API de análise da Microsoft Store e no download offline do Relatório de avaliações.Review IDs are available in the response data of the get app reviews method in the Microsoft Store analytics API and in the offline download of the Reviews report.

SolicitaçãoRequest

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
OBTERGET https://manage.devcenter.microsoft.com/v1.0/my/reviews/{reviewId}/apps/{applicationId}/responses/info

Cabeçalho da solicitaçãoRequest header

CabeçalhoHeader TipoType DescriçãoDescription
AutorizaçãoAuthorization cadeia de caracteresstring Obrigatório.Required. O token de acesso do AD do Azure no formato portador < token>.The Azure AD access token in the form Bearer <token>.

Parâmetros solicitadosRequest parameters

ParâmetroParameter TipoType DescriçãoDescription ObrigatórioRequired
applicationIdapplicationId cadeia de caracteresstring A ID da Loja do aplicativo que contém a análise para a qual você deseja determinar se pode responder.The Store ID of the app that contains the review for which you want to determine whether you can respond to. A ID de Store está disponível na página de aplicativo de identidade no Partner Center.The Store ID is available on the App identity page in Partner Center. Um exemplo de ID da Loja é 9WZDNCRFJ3Q8.An example Store ID is 9WZDNCRFJ3Q8. SimYes
reviewIdreviewId cadeia de caracteresstring A ID da revisão que você deseja responder (este é um GUID).The ID of the review you want to respond to (this is a GUID). As IDs de revisão estão disponíveis nos dados de resposta do método obter avaliações de app na API de análise da Microsoft Store e no download offline do Relatório de avaliações.Review IDs are available in the response data of the get app reviews method in the Microsoft Store analytics API and in the offline download of the Reviews report.
Se você omitir esse parâmetro, o corpo da resposta para esse método indicará se você tem permissões para responder a quaisquer análises para o aplicativo especificado.If you omit this parameter, the response body for this method will indicate whether you have permissions to respond to any reviews for the specified app.
NãoNo

Exemplo de solicitaçãoRequest example

Os exemplos a seguir mostram como usar esse método para determinar se você pode responder a uma determinada análise.The following examples how to use this method to determine whether you can respond to a given review.

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>

RespostaResponse

Corpo da respostaResponse body

ValorValue TipoType DescriçãoDescription
CanRespondCanRespond BoolianoBoolean O valor true indica que você pode responder à análise especificado, ou que você tem permissões para responder a qualquer análise do aplicativo especificado.The value true indicates that you can respond to the specified review, or that you have permissions to respond to any review for the specified app. Caso contrário, esse valor é false.Otherwise, this value is false.
DefaultSupportEmailDefaultSupportEmail cadeia de caracteresstring O endereço de email de suporte do seu aplicativo, conforme especificado na listagem da Loja do seu aplicativo.Your app's support email address as specified in your app's Store listing. Se você não especificar um endereço de email de suporte, esse campo ficará vazio.If you did not specify a support email address, this field is empty.

 

Exemplo de respostaResponse example

O código a seguir demonstra um exemplo de corpo de resposta JSON para essa solicitação.The following example demonstrates an example JSON response body for this request.

{
  "CanRespond": true,
  "DefaultSupportEmail": "support@contoso.com"
}