Ottenere informazioni sulla risposta a recensioniGet response info for reviews

Se vuoi rispondere a livello di codice alla recensione di un cliente della tua app, puoi utilizzare questo metodo nell'API di recensione di Microsoft Store per determinare innanzitutto se hai l'autorizzazione per rispondere alla recensione.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. Non è possibile rispondere alle recensioni inviate dai clienti che hanno scelto di non ricevere risposte alle recensioni.You cannot respond to reviews submitted by customers who have chosen not to receive review responses. Dopo avere confermato di poter rispondere alla recensione, puoi utilizzare il metodo inviare risposte alle recensioni di app per rispondere a livello di codice.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.

PrerequisitiPrerequisites

Per usare questo metodo, devi prima eseguire le operazioni seguenti:To use this method, you need to first do the following:

  • Se non lo hai già fatto, completa tutti i prerequisiti per l'API di analisi di Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • Ottieni un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo.Obtain an Azure AD access token to use in the request header for this method. Dopo aver ottenuto un token di accesso, hai 60 minuti per usarlo prima che scada.After you obtain an access token, you have 60 minutes to use it before it expires. Dopo la scadenza del token, puoi ottenerne uno nuovo.After the token expires, you can obtain a new one.
  • Ottieni l'ID della recensione che desideri controllare per determinare se puoi rispondere.Get the ID of the review you want to check to determine whether you can respond to it. Gli ID recensione sono disponibili nei dati delle risposte del metodo ottenere le recensioni di app nell'API di analisi di Microsoft Store e in scarica offline di report recensioni.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.

RichiestaRequest

Sintassi della richiestaRequest syntax

MetodoMethod URI richiestaRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/reviews/{reviewId}/apps/{applicationId}/responses/info

Intestazione della richiestaRequest header

IntestazioneHeader TipoType DescrizioneDescription
AuthorizationAuthorization stringstring Obbligatorio.Required. Il token di accesso di Azure AD nel formato Bearer < token>.The Azure AD access token in the form Bearer <token>.

Parametri della richiestaRequest parameters

ParametroParameter TipoType DescrizioneDescription ObbligatorioRequired
applicationIdapplicationId stringstring ID dello Store dell'app che contiene la recensione per cui si desidera determinare se è possibile rispondere.The Store ID of the app that contains the review for which you want to determine whether you can respond to. L'ID di Store è disponibile nel pagina dell'identità App nel centro per i Partner.The Store ID is available on the App identity page in Partner Center. Un esempio di ID dello Store è 9WZDNCRFJ3Q8.An example Store ID is 9WZDNCRFJ3Q8. YesYes
reviewIdreviewId stringstring L'ID della recensione a cui vuoi rispondere a (questo è un GUID).The ID of the review you want to respond to (this is a GUID). Gli ID recensione sono disponibili nei dati delle risposte del metodo ottenere le recensioni di app nell'API di analisi di Microsoft Store e in scarica offline di report recensioni.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 ometti questo parametro, il contenuto della risposta per questo metodo indicherà se si ha l'autorizzazione a rispondere a qualsiasi recensioni per l'app specificata.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.
NoNo

Esempio di richiestaRequest example

Gli esempi seguenti illustrano come usare questo metodo per determinare se puoi rispondere a una recensione specificata.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>

RispostaResponse

Contenuto della rispostaResponse body

ValueValue TipoType DescrizioneDescription
CanRespondCanRespond BooleanoBoolean Il valore true indica che puoi rispondere alla revisione specificata o che hai l'autorizzazione a rispondere a qualsiasi recensione per l'app specificata.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. In caso contrario, questo valore è false.Otherwise, this value is false.
DefaultSupportEmailDefaultSupportEmail stringstring L'indirizzo di posta elettronica di supporto dell'app come specificato nella presentazione nello Store della tua app.Your app's support email address as specified in your app's Store listing. Se non hai specificato un indirizzo di posta elettronica di supporto, questo campo è vuoto.If you did not specify a support email address, this field is empty.

 

Esempio di rispostaResponse example

L'esempio seguente illustra un esempio di corpo della risposta JSON per questa richiesta.The following example demonstrates an example JSON response body for this request.

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