Rispondere alle recensioni utilizzando i servizi dello Store

  • Articolo

Importante

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

Utilizza l'API delle recensioni di Microsoft Store per inviare a livello di codice le risposte alle recensioni della tua app nello Store. Questa API è particolarmente utile per gli sviluppatori che desiderano rispondere in blocco a molte recensioni senza utilizzare il Centro per i partner. Questa API usa Azure Active Directory (Azure AD) per autenticare le chiamate dall'app o dal servizio.

I seguenti passaggi descrivono il processo end-to-end:

  1. Assicurati di aver completato tutti i prerequisiti.
  2. Prima di chiamare un metodo nell'API di revisione di Microsoft Store, ottieni un token di accesso di Azure AD. Dopo aver ottenuto un token, hai 60 minuti per utilizzarlo nelle chiamate all'API di revisione di Microsoft Store prima della scadenza del token. Dopo la scadenza del token, puoi generare un nuovo token.
  3. Chiama l'API delle recensioni di Microsoft Store.

Nota

Oltre a utilizzare l'API delle recensioni di Microsoft Store per rispondere alle recensioni a livello di codice, puoi in alternativa rispondere alle recensioni utilizzando il Partner Center.

Passaggio 1: completare i prerequisiti per l'utilizzo dell'API delle recensioni di Microsoft Store

Prima di iniziare a scrivere il codice per chiamare l'API delle recensioni di Microsoft Store, assicurati di aver completato i prerequisiti seguenti.

  • L'utente o l'organizzazione deve disporre di una directory di Azure AD e dell'autorizzazione come amministratore aziendale per la directory. Se si usa già Microsoft 365 o altri servizi aziendali Microsoft, si dispone già di una directory di Azure AD. Altrimenti puoi creare un nuovo Azure AD nel Centro per i partner senza costi aggiuntivi.

  • È necessario associare un'applicazione Azure AD all'account del Centro per i partner, recuperare l'ID tenant e l'ID client per l'applicazione e generare una chiave. L'applicazione Azure AD rappresenta l'app o il servizio da cui vuoi chiamare l'API delle recensioni di Microsoft Store. Per ottenere un token di accesso di Azure AD da passare all'API, sono necessari l'ID tenant, l'ID client e la chiave.

    Nota

    È sufficiente eseguire questa attività una sola volta. Quando si dispone di ID tenant, ID client e chiave, è possibile riutilizzarli ogni volta che è necessario creare un nuovo token di accesso Azure AD.

Per associare un'applicazione Azure AD al tuo account del Centro per i partner e recuperare i valori richiesti:

  1. Nel Centro per i partner, associare l'account del Centro per i partner dell'organizzazione alla directory di Azure AD dell'organizzazione.

  2. Successivamente, dalla pagina Utenti nella sezione Impostazioni account del Partner Center, aggiungi l'applicazione Azure ADche rappresenta l'app o il servizio che utilizzerai per rispondere alle recensioni. Assicurarsi di assegnare a questa applicazione il ruolo di Manager. Se l'applicazione non esiste ancora nella directory di Azure AD, è possibile creare una nuova applicazione Azure AD nel Centro per i partner.

  3. Tornare alla pagina Utenti, fare clic sul nome dell'applicazione Azure AD per passare alle impostazioni e copiare i valori di ID tenant e ID client.

  4. Fare clic su Aggiungi nuova chiave. Nella schermata seguente, copiare il valore della chiave. Non sarà più possibile accedere a queste informazioni dopo aver lasciato la pagina. Per altre informazioni, vedi Gestire le chiavi per un'applicazione Azure AD.

Passaggio 2: ottenere un token di accesso di Azure AD

Prima di chiamare uno qualsiasi dei metodi nell'API di revisione di Microsoft Store, devi innanzitutto ottenere un token di accesso di Azure AD da passare all'intestazione Autorizzazione di ciascun metodo nell'API. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile aggiornarlo in modo da continuare a usarlo nelle successive chiamate all'API.

Per ottenere il token di accesso, seguire le istruzioni riportate in Chiamate da servizio a servizio mediante le credenziali client per inviare un HTTP POST all'endpoint https://login.microsoftonline.com/<tenant_id>/oauth2/token. Di seguito è riportata una richiesta di esempio.

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com

Per il valore tenant_id in POST URI e per i parametri client_id e client_secret, specificare l'ID tenant, l'ID client e la chiave per l'applicazione recuperati dal Centro per i partner nella sezione precedente. Per il parametro resource è necessario specificare https://manage.devcenter.microsoft.com.

Una volta scaduto il token di accesso, puoi aggiornarlo seguendo le istruzioni qui.

Passaggio 3: richiama l'API delle recensioni di Microsoft Store

Dopo aver ottenuto un token di accesso di Azure AD, sei pronto per chiamare l'API di revisione di Microsoft Store. È necessario passare il token di accesso all'intestazioneAuthorization di ciascun metodo.

L'API delle recensioni di Microsoft Store contiene diversi metodi che puoi utilizzare per determinare se sei autorizzato a rispondere a una determinata recensione e a inviare risposte a una o più recensioni. Segui questa procedura per utilizzare questa API:

  1. Ottieni gli ID delle recensioni a cui vuoi rispondere. Gli ID revisione sono disponibili nei dati di risposta del metodo ottenere recensioni sull'app nell'API di analisi di Microsoft Store e nel download offline di [Reviews report](/windows/apps/publish/reviews-report).
  2. Chiama il metodo Ottieni informazioni di risposta per le recensioni delle app per determinare se sei autorizzato a rispondere alle recensioni. Quando un cliente invia una recensione, può scegliere di non ricevere risposte alla sua recensione. Non puoi rispondere alle recensioni inviate dai clienti che hanno scelto di non ricevere risposte alle recensioni.
  3. Chiama il metododi invio delle risposte alle recensioni delle app per rispondere alle recensioni in modo programmatico.