Inviare risposte alle 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 ottenere le stesse attività usando il Centro per i partner.

Usa questo metodo nell'API recensioni Microsoft Store per rispondere a livello di codice alle recensioni della tua app. Quando si chiama questo metodo, è necessario specificare gli ID delle recensioni a cui si vuole rispondere. Gli ID di revisione sono disponibili nei dati di risposta del metodo Ottenere le recensioni dell'app nell'API di analisi di Microsoft Store e nel download offline del report Recensioni.

Quando un cliente invia una recensione, può scegliere di non ricevere risposte alla revisione. Se si tenta di rispondere a una verifica per cui il cliente ha scelto di non ricevere risposte, il corpo della risposta di questo metodo indicherà che il tentativo di risposta non è riuscito. Prima di chiamare questo metodo, è possibile determinare facoltativamente se è consentito rispondere a una determinata recensione usando il metodo Ottenere informazioni sulla risposta per le recensioni delle app.

Nota

Oltre a usare questo metodo per rispondere a livello di codice alle recensioni, è possibile rispondere in alternativa alle recensioni usando il Centro per i partner.

Prerequisiti

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

  • Se non lo si ha ancora fatto, completare i prerequisiti per l'API recensioni 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 gli ID delle recensioni a cui si vuole rispondere. Gli ID di revisione sono disponibili nei dati di risposta del metodo Ottenere le recensioni dell'app nell'API di analisi di Microsoft Store e nel download offline del report Recensioni.

Richiedi

Sintassi della richiesta

metodo URI della richiesta
POST https://manage.devcenter.microsoft.com/v1.0/my/reviews/responses

Intestazione della richiesta

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

Parametri della richiesta

Questo metodo non richiede parametri.

Corpo della richiesta

Il corpo della richiesta presenta i seguenti valori.

Valore Tipo Descrizione
Risposte array Matrice di oggetti che contengono i dati di risposta da inviare. Per altre informazioni sui dati in ogni oggetto, vedere la tabella seguente.

Ogni oggetto nella matrice Risposte contiene i valori seguenti.

Valore Tipo Descrizione Richiesto
Applicationid string ID dello Store dell'app con la recensione a cui vuoi rispondere. L'ID dello Store è disponibile nella pagina di identità app del 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 di revisione sono disponibili nei dati di risposta del metodo Ottenere le recensioni dell'app nell'API di analisi di Microsoft Store e nel download offline del report Recensioni. Sì
ResponseText string La risposta che si desidera inviare. La risposta deve seguire queste linee guida. Sì
SupportEmail string Indirizzo di posta elettronica di supporto dell'app, che il cliente può usare per contattare direttamente l'utente. Deve essere un indirizzo e-mail valido. Sì
IsPublic Booleano Se specifichi true, la risposta verrà visualizzata nella presentazione nello Store della tua app, direttamente sotto la recensione del cliente e sarà visibile a tutti i clienti. Se si specifica false e l'utente non ha rifiutato di ricevere risposte tramite posta elettronica, la risposta verrà inviata al cliente tramite posta elettronica e non sarà visibile ad altri clienti nella presentazione nello Store dell'app. Se si specifica false e l'utente ha rifiutato di ricevere risposte tramite posta elettronica, verrà restituito un errore. Sì

Esempio di richiesta

Nell'esempio seguente viene illustrato come usare questo metodo per inviare risposte a diverse recensioni.

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
    }
  ]
}

Response

Corpo della risposta

Valore Tipo Descrizione
Risultato array Matrice di oggetti che contengono dati su ogni risposta inviata. Per altre informazioni sui dati in ogni oggetto, vedere la tabella seguente.

Ogni oggetto nella matrice Risultato contiene i valori seguenti.

Valore Tipo Descrizione
Applicationid string L'ID dello Store dell'app con la recensione a cui hai risposto. Un esempio di ID dello Store è 9WZDNCRFJ3Q8.
ReviewId string ID della recensione a cui hai risposto. È un GUID.
Completato string Il valore true indica che la risposta è stata inviata correttamente. Il valore false indica che la risposta non è riuscita.
FailureReason string Se Successful è false, questo valore contiene un motivo per l'errore. Se Successful è true, questo valore è vuoto.

Risposta di esempio

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

{
  "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"
    }
  ]
}