Ottenere le recensioni dell'app

  • Articolo

Usare questo metodo nell'API di analisi di Microsoft Store per ottenere i dati sulle recensioni in formato JSON per un determinato intervallo di date e altri filtri opzionali. Queste informazioni sono disponibili anche nel report sulle recensioni nel Centro per i partner.

Dopo aver recuperato le recensioni, è possibile usare i metodi di recupero delle informazioni sulle risposte per le recensioni delle app e di invio delle risposte alle recensioni sulle app nell'API delle recensioni di Microsoft Store per rispondere a livello di codice alle recensioni.

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.

Richiesta

Sintassi della richiesta

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

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 per cui si desidera recuperare i dati sulle recensioni. Sì
startDate data Data di inizio nell'intervallo di date dei dati sulle recensioni da recuperare. L'impostazione predefinita è la data corrente. No
endDate data Data di fine nell'intervallo di date dei dati sulle recensioni da recuperare. L'impostazione predefinita è la data corrente. No
migliori int Numero di righe di dati da restituire nella richiesta. Il valore massimo e il valore predefinito, se non specificati, sono pari a 10000. Se nella query sono presenti più righe, il corpo della risposta includerà un collegamento che consente di richiedere la pagina successiva dei dati. No
skip int Numero di righe da ignorare nella query. Usare questo parametro per scorrere i set di dati di grandi dimensioni. Ad esempio, top=10000 e skip=0 recupera le prime 10.000 righe di dati, top=10000 e skip=10000 recupera le 10.000 righe di dati successive e così via. No
filter string Una o più istruzioni che filtrano le righe nella risposta. Per ulteriori informazioni, vedere la sezione Campi filtro seguente. No
orderby string Istruzione che ordina i valori dei dati dei risultati. La sintassi è orderby=field [order],field [order],.... Il parametro field può essere una delle stringhe seguenti:
  • date
  • osVersion
  • market
  • deviceType
  • isRevised
  • packageVersion
  • deviceModel
  • productFamily
  • deviceScreenResolution
  • isTouchEnabled
  • reviewerName
  • reviewTitle
  • reviewText
  • helpfulCount
  • notHelpfulCount
  • responseDate
  • responseText
  • deviceRAM
  • deviceStorageCapacity
  • rating

Il parametro order è facoltativo e può essere asc o desc per specificare l'ordine crescente o decrescente di ogni campo. Il valore predefinito è asc.

Di seguito è riportato un esempio di stringa orderby: orderby=date,market

 No

Campi filtro

Il parametro filter della richiesta contiene una o più istruzioni che filtrano le righe nella risposta. Ogni istruzione contiene un campo e un valore associati agli operatori eq o ne e alcuni campi supportano anche gli operatori contains, gt, lt, ge e le. Le istruzioni possono essere combinate usando and o or.

Di seguito è riportato un esempio di stringa filter: filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US'

Per un elenco dei campi supportati e degli operatori di supporto per ogni campo, vedere la tabella seguente. I valori stringa devono essere racchiusi tra virgolette singole nel parametro filter.

Campi Operatori supportati Descrizione
market eq, ne Stringa che contiene il codice Paese ISO 3166 del mercato del dispositivo.
osVersion eq, ne Una delle stringhe seguenti:
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Unknown
deviceType eq, ne Una delle stringhe seguenti:
  • PC
  • Telefono
  • Console-Xbox One
  • Console-Xbox Series X
  • IoT
  • Holographic
  • Unknown
isRevised eq, ne Specificare true per filtrare le recensioni che sono state riviste, altrimenti specificare false.
packageVersion eq, ne Versione del pacchetto dell'app recensita.
deviceModel eq, ne Tipo di dispositivo in cui è stata recensita l'app.
productFamily eq, ne Una delle stringhe seguenti:
  • PC
  • Tablet
  • Telefono
  • Wearable
  • Server
  • Collaborazione
  • Altro
deviceRAM eq, ne, gt, lt, ge, le RAM fisica in MB.
deviceScreenResolution eq, ne Risoluzione dello schermo del dispositivo nel formato "larghezza x altezza".
deviceStorageCapacity eq, ne, gt, lt, ge, le Capacità del disco di archiviazione primario in GB.
isTouchEnabled eq, ne Specificare true per filtrare i dispositivi abilitati per il tocco, in caso contrario , false.
reviewerName eq, ne Nome del recensore.
rating eq, ne, gt, lt, ge, le Valutazione dell'app in stelle.
reviewTitle eq, ne, contains Titolo della recensione.
reviewText eq, ne, contains Contenuto di testo della recensione.
helpfulCount eq, ne Numero di volte in cui la recensione è stata contrassegnata come utile.
notHelpfulCount eq, ne Numero di volte in cui la recensione è stata contrassegnata come non utile.
responseDate eq, ne Data di invio della risposta.
responseText eq, ne, contains Contenuto di testo della risposta.
id eq, ne ID della recensione (GUID).

Esempio di richiesta

Gli esempi seguenti illustrano diverse richieste di recupero dei dati sulle recensioni. Sostituire il valore applicationId con l'ID dello Store dell'app.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US' HTTP/1.1
Authorization: Bearer <your access token>

Response

Corpo della risposta

Valore Tipo Descrizione
Valore matrice Matrice di oggetti che contengono i dati delle recensioni. Per ulteriori informazioni sui dati in ogni oggetto, vedere la sezione Valori recensioni seguente.
@nextLink string Se vi sono ulteriori pagine di dati, la stringa conterrà un URI che è possibile usare per richiedere la pagina di dati successiva. Ad esempio, questo valore viene restituito se il parametro top della richiesta è impostato su 10000 ma vi sono più di 10.000 righe di dati sulle recensioni per la query.
TotalCount int Numero totale di righe nei risultati di dati per la query.

 

Valori recensioni

Gli elementi nella matrice Value contengono i valori seguenti.

Valore Tipo Descrizione
data string Prima data dell'intervallo di date per i dati sulle recensioni. Se la richiesta ha specificato un singolo giorno, questo valore corrisponde alla data. Se la richiesta ha specificato una settimana, un mese o un altro intervallo di date, questo valore corrisponde alla prima data nell'intervallo di date.
applicationId string ID dello Store dell'app per cui si stanno recuperando i dati sulle recensioni.
applicationName string Nome visualizzato dell'app.
market string Codice Paese ISO 3166 del mercato in cui è stata inviata la recensione.
osVersion string Versione del sistema operativo in cui è stata inviata la recensione. Per un elenco delle stringhe supportate, vedere la sezione Campi filtro precedente.
deviceType string Tipo di dispositivo in cui è stata inviata la recensione. Per un elenco delle stringhe supportate, vedere la sezione Campi filtro precedente.
isRevised Booleano Il valore true indica che la recensione è stata rivista, il valore false che non lo è stata.
packageVersion string Versione del pacchetto dell'app recensita.
deviceModel string Tipo di dispositivo in cui è stata recensita l'app.
productFamily string Nome della famiglia di dispositivi. Per un elenco delle stringhe supportate, vedere la sezione Campi filtro precedente.
deviceRAM Numero RAM fisica in MB.
deviceScreenResolution string Risoluzione dello schermo del dispositivo nel formato "larghezza x altezza".
deviceStorageCapacity Numero Capacità del disco di archiviazione primario in GB.
isTouchEnabled Booleano Il valore true indica che il tocco è abilitato, , false indica che non lo è.
reviewerName string Nome del recensore.
rating Numero Valutazione dell'app in stelle.
reviewTitle string Titolo della recensione.
reviewText string Contenuto di testo della recensione.
helpfulCount Numero Numero di volte in cui la recensione è stata contrassegnata come utile.
notHelpfulCount Numero Numero di volte in cui la recensione è stata contrassegnata come non utile.
responseDate string Data di invio di una risposta.
responseText string Contenuto di testo della risposta.
id string ID della recensione (GUID). È possibile usare questo ID nei metodi di recupero delle informazioni sulle risposte per le recensioni sulle app e di invio delle risposte alle recensioni sulle app.

Esempio di richiesta e risposta

I frammenti di codice seguenti illustrano alcune richieste di esempio e il corpo della risposta JSON per tali richieste.

Richiesta di esempio

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9WZDNCRFJB4P&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

Risposta di esempio

{
    "Value": [
        {
            "date": "3/5/2021 12:48:33 PM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "ES",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "Jose Antonio",
            "rating": 5,
            "reviewTitle": "Contoso Demo",
            "reviewText": "Un juego fantastico",
            "helpfulCount": 3,
            "notHelpfulCount": 0,
            "id": "b5e27de9-2334-4849-d17d-4eae3e1e7aa9"
        },
        {
            "date": "1/6/2021 8:41:42 AM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "TR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "fef",
            "rating": 5,
            "helpfulCount": 0,
            "notHelpfulCount": 0,
            "id": "f5d2510a-9796-45ee-01e5-6d5cc4550b09"
        }
    ],
    "TotalCount": 2
}