REST Resource: reviews

Risorsa: Review

Una recensione di un'app per Android.

Rappresentazione JSON 
{
  "reviewId": string,
  "authorName": string,
  "comments": [
    {
      object (Comment)
    }
  ]
}
Campi
reviewId

string

Identificatore univoco per questa recensione.
authorName

string

Il nome dell'utente che ha scritto la recensione.
comments[]

object (Comment)

Un campo ripetuto contenente i commenti per la recensione.

Commento

Una voce di conversazione tra l'utente e lo sviluppatore.

Rappresentazione JSON 
{

  // Union field comment can be only one of the following:
  "userComment": {
    object (UserComment)
  },
  "developerComment": {
    object (DeveloperComment)
  }
  // End of list of possible types for union field comment.
}
Campi

Campo unione comment.

comment può essere solo uno dei seguenti tipi:
userComment

object (UserComment)

Un commento di un utente.
developerComment

object (DeveloperComment)

Un commento di uno sviluppatore.

UserComment

Inserimento dell'utente dalla conversazione tra l'utente e lo sviluppatore.

Rappresentazione JSON 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  },
  "starRating": integer,
  "reviewerLanguage": string,
  "device": string,
  "androidOsVersion": integer,
  "appVersionCode": integer,
  "appVersionName": string,
  "thumbsUpCount": integer,
  "thumbsDownCount": integer,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "originalText": string
}
Campi
text

string

Il contenuto del commento, ovvero il corpo della recensione. In alcuni casi, gli utenti sono stati in grado di scrivere una recensione con titolo e corpo separati; in questi casi, il titolo e il corpo vengono concatenati e separati da un carattere di tabulazione.
lastModified

object (Timestamp)

L'ultima volta che questo commento è stato aggiornato.
starRating

integer

La valutazione a stelle associata alla recensione, da 1 a 5.
reviewerLanguage

string

Codice lingua del recensore. Queste informazioni vengono prese dalle impostazioni del dispositivo, pertanto non è garantito che corrispondano alla lingua in cui è scritta la recensione. Potrebbe essere assente.
device

string

Nome in codice del dispositivo del recensore, ad es. klte, flounder. Potrebbe essere assente.
androidOsVersion

integer

Versione SDK Android intera del dispositivo dell'utente al momento della stesura della recensione, ad esempio 23 è Marshmallow. Potrebbe essere assente.
appVersionCode

integer

Codice di versione intero dell'app installata al momento della stesura della recensione. Potrebbe essere assente.
appVersionName

string

Nome della versione stringa dell'app installata al momento della stesura della recensione. Potrebbe essere assente.
thumbsUpCount

integer

Numero di utenti che hanno messo Mi piace a questa recensione.
thumbsDownCount

integer

Numero di utenti che hanno assegnato un pollice verso a questa recensione.
deviceMetadata

object (DeviceMetadata)

Informazioni sulle caratteristiche del dispositivo dell'utente.
originalText

string

Testo non tradotto della recensione, se è stata tradotta. Se la recensione non è stata tradotta, questo campo viene lasciato vuoto.

Timestamp

Un timestamp rappresenta un momento specifico indipendente da qualsiasi fuso orario o calendario locale, codificato come conteggio di secondi e frazioni di secondi con risoluzione al nanosecondo. Il conteggio è relativo a un'epoca a mezzanotte UTC del 1° gennaio 1970.

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi del tempo UTC dall'epoca Unix.
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Deve essere compreso tra 0 e 999.999.999 inclusi.

DeviceMetadata

Caratteristiche del dispositivo dell'utente.

Rappresentazione JSON 
{
  "productName": string,
  "manufacturer": string,
  "deviceClass": string,
  "screenWidthPx": integer,
  "screenHeightPx": integer,
  "nativePlatform": string,
  "screenDensityDpi": integer,
  "glEsVersion": integer,
  "cpuModel": string,
  "cpuMake": string,
  "ramMb": integer
}
Campi
productName

string

Nome del modello del dispositivo (ad es. Droid)
manufacturer

string

Produttore del dispositivo (ad es. Motorola)
deviceClass

string

Classe del dispositivo (ad es. tablet)
screenWidthPx

integer

Larghezza dello schermo in pixel
screenHeightPx

integer

Altezza dello schermo in pixel
nativePlatform

string

Elenco separato da virgole di piattaforme native (ad es. "arm", "arm7")
screenDensityDpi

integer

Densità schermo in DPI
glEsVersion

integer

Versione OpenGL
cpuModel

string

Modello di CPU del dispositivo, ad esempio "MSM8974"
cpuMake

string

Marca della CPU del dispositivo, ad esempio "Qualcomm"
ramMb

integer

RAM del dispositivo in megabyte, ad esempio "2048"

DeveloperComment

Voce dello sviluppatore dalla conversazione tra l'utente e lo sviluppatore.

Rappresentazione JSON 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  }
}
Campi
text

string

Il contenuto del commento, ovvero il corpo della risposta.
lastModified

object (Timestamp)

L'ultima volta che questo commento è stato aggiornato.

Metodi

get

 Riceve una sola recensione.

list

 Elenca tutte le recensioni.

reply

 Risponde a una singola recensione o aggiorna una risposta esistente.

Codici di errore

Le operazioni di questa risorsa restituiscono i seguenti codici di errore HTTP:

Codice di errore Motivo Descrizione Risoluzione
400 invalidValue Nella richiesta è stato fornito un valore non valido. Questo errore viene spesso restituito per un token di acquisto non valido o con un formato non corretto. Correggi il valore del campo non valido nel corpo della richiesta o nei parametri in base al riferimento API.
400 required Nella richiesta manca un campo o un parametro obbligatorio. Consulta la documentazione dell'API per assicurarti di includere tutti i campi e i parametri obbligatori.
403 userInsufficientPermission L'utente non dispone di autorizzazioni sufficienti per eseguire l'operazione richiesta. Assicurati che l'utente autenticato disponga delle autorizzazioni necessarie in Google Play Console. Per ulteriori dettagli, consulta Utilizzo di un service account.
404 notFound Impossibile trovare la risorsa richiesta. Verifica che gli identificatori (ad es. token di acquisto, nome del pacchetto, ID prodotto, ID abbonamento) siano corretti.
409 concurrentUpdate È stato effettuato un tentativo di aggiornamento di un oggetto in fase di aggiornamento simultaneo. Riprova a inviare la richiesta con il backoff esponenziale. Evita modifiche simultanee alla stessa risorsa.
5xx Generic error Errore generico nel server Google Play. Riprova a inviare la richiesta.

Se il problema persiste, contatta il tuo Account Manager Google Play o invia una richiesta di assistenza. Ti consigliamo di controllare la dashboard dello stato di Play per eventuali interruzioni note.