REST Resource: reviews

Risorsa: revisione

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:
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 una risoluzione di nanosecondi. 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 a partire 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 es. "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 Risoluzione
5xx 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.
409 Errore di aggiornamento della concorrenza.

È stato effettuato un tentativo di aggiornamento di un oggetto in fase di aggiornamento. Ad esempio, un acquisto viene confermato chiamando il metodo acknowledgePurchase() della libreria Fatturazione Play e chiamando contemporaneamente il metodo purchases.products.acknowledge dell'API Play Developer.

 Riprova a inviare la richiesta.