Ottenere le recensioni dell'app
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.
Richiedi
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:
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:
|
deviceType | eq, ne | Una delle stringhe seguenti:
|
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:
|
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 | number | RAM fisica in MB. |
deviceScreenResolution | string | Risoluzione dello schermo del dispositivo nel formato "larghezza x altezza". |
deviceStorageCapacity | number | 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 | number | Valutazione dell'app in stelle. |
reviewTitle | string | Titolo della recensione. |
reviewText | string | Contenuto di testo della recensione. |
helpfulCount | number | Numero di volte in cui la recensione è stata contrassegnata come utile. |
notHelpfulCount | number | 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
}
Argomenti correlati
- Report recensioni
- Accedere ai dati di analisi usando i servizi di Microsoft Store
- Ottenere informazioni sulla risposta alle recensioni delle app
- Inviare risposte alle recensioni sulle app
- Ottenere le acquisizioni dell'app
- Ottenere le acquisizioni dei componenti aggiuntivi
- Ottenere i dati di segnalazione degli errori
- Ottenere le classificazioni dell'app