Recuperare informazioni sulla risposta a recensioni

  • Articolo

Importante

L'API delle recensioni di Microsoft Store, come documentato in questo argomento, non è attualmente in uno stato di lavoro. Anziché usare le API, è possibile svolgere le stesse attività usando il Centro per i partner.

Se si desidera rispondere a livello di codice a una recensione di un cliente sull'app, è possibile usare questo metodo nell'API delle recensioni di Microsoft Store per determinare innanzitutto se si ha l'autorizzazione per rispondere alla recensione. Non è possibile rispondere alle recensioni inviate dai clienti che hanno scelto di non ricevere risposte. Dopo aver verificato di poter rispondere alla recensione, è possibile usare il metodo di invio di risposte alle recensioni dell'app per rispondere a livello di codice.

Prerequisiti

Per usare questo metodo, è necessario prima eseguire le operazioni seguenti:

  • Se non lo si è ancora fatto, completare i prerequisiti per l'API di analisi di Microsoft Store.
  • Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.
  • Ottenere l'ID della recensione che si desidera controllare per determinare se è possibile rispondere. Gli ID delle recensioni sono disponibili nei dati della risposta del metodo di recupero delle recensioni sulle app nell'API di analisi di Microsoft Store e nel download offline del report sulle recensioni.

Richiedi

Sintassi della richiesta

metodo URI della richiesta
GET https://manage.devcenter.microsoft.com/v1.0/my/reviews/{reviewId}/apps/{applicationId}/responses/info

Intestazione della richiesta

Intestazione Type Descrizione
Autorizzazione stringa Obbligatorio. Token di accesso di Azure AD nel formato Token di<connessione>.

Parametri della richiesta

Parametro Tipo Descrizione Richiesto
applicationId string ID dello Store dell'app che contiene la recensione per cui si desidera determinare se è possibile rispondere. L'ID dello Store è disponibile nella pagina di identity app nel Centro per i partner. Un esempio di ID dello Store è 9WZDNCRFJ3Q8. Sì
reviewId string ID della recensione a cui si vuole rispondere (si tratta di un GUID). Gli ID delle recensioni sono disponibili nei dati della risposta del metodo di recupero delle recensioni sulle app nell'API di analisi di Microsoft Store e nel download offline del report sulle recensioni.
Se si omette questo parametro, il corpo della risposta per questo metodo indicherà se si dispone delle autorizzazioni per rispondere alle recensioni per l'app specificata.		 No

Esempio di richiesta

Gli esempi seguenti illustrano come usare questo metodo per determinare se è possibile rispondere a una determinata recensione.

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>

Response

Corpo della risposta

| Valore | Tipo | Descrizione |
|------------|--------|-----------------------| | CanRespond | Booleano | Il valore true indica che è possibile rispondere alla recensione specificata, oppure che si hanno le autorizzazioni per rispondere a qualsiasi recensione per l'app specificata. In caso contrario, questo valore è false. | | DefaultSupportEmail | Stringa | L'indirizzo email di supporto dell'app specificato nella presentazione dell'app nello Store. Se non si è specificato un indirizzo email di supporto, questo campo è vuoto. |  

Risposta di esempio

L'esempio seguente illustra un esempio di corpo della risposta JSON per questa richiesta.

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