REST Resource: reviews

Ressource: Rezension

Eine Rezension einer Android-App.

JSON-Darstellung 
{
  "reviewId": string,
  "authorName": string,
  "comments": [
    {
      object (Comment)
    }
  ]
}
Felder
reviewId

string

Eindeutige Kennung für diese Rezension.
authorName

string

Der Name des Nutzers, der die Rezension geschrieben hat.
comments[]

object (Comment)

Ein wiederkehrendes Feld mit Kommentaren zur Rezension.

Kommentar

Ein Eintrag der Unterhaltung zwischen Nutzer und Entwickler.

JSON-Darstellung 
{

  // 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.
}
Felder

Union-Feld comment.

Für comment ist nur einer der folgenden Werte zulässig:
userComment

object (UserComment)

Einen Kommentar eines Nutzers
developerComment

object (DeveloperComment)

Einen Kommentar eines Entwicklers

UserComment

Eingabe des Nutzers aus der Unterhaltung zwischen Nutzer und Entwickler.

JSON-Darstellung 
{
  "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
}
Felder
text

string

Der Inhalt des Kommentars, d.h. der Text der Rezension. In einigen Fällen konnten Nutzer eine Rezension mit separatem Titel und Textkörper schreiben. In diesen Fällen werden Titel und Textkörper verkettet und durch ein Tabulatorzeichen getrennt.
lastModified

object (Timestamp)

Der Zeitpunkt, zu dem dieser Kommentar zuletzt aktualisiert wurde.
starRating

integer

Die mit der Rezension verknüpfte Sternebewertung (1 bis 5).
reviewerLanguage

string

Sprachcode für den Rezensenten. Diese Information stammt aus den Geräteeinstellungen und stimmt nicht unbedingt mit der Sprache überein, in der die Rezension verfasst wurde. Kann fehlen.
device

string

Der Codename für das Gerät des Rezensenten, z.B. „klte“ oder „flounder“. Kann fehlen.
androidOsVersion

integer

Die Android-SDK-Version des Geräts des Nutzers zum Zeitpunkt des Verfassens der Rezension als Ganzzahl, z.B. 23 für Marshmallow. Kann fehlen.
appVersionCode

integer

Ganzzahliger Versionscode der App, wie sie zum Zeitpunkt des Verfassens der Rezension installiert war. Kann fehlen.
appVersionName

string

Der String-Versionsname der App, wie er zum Zeitpunkt des Verfassens der Rezension installiert war. Kann fehlen.
thumbsUpCount

integer

Anzahl der Nutzer, die dieser Rezension ein Like gegeben haben.
thumbsDownCount

integer

Anzahl der Nutzer, die diese Rezension mit „Gefällt mir nicht“ bewertet haben.
deviceMetadata

object (DeviceMetadata)

Informationen zu den Eigenschaften des Geräts des Nutzers.
originalText

string

Nicht übersetzter Text der Rezension, falls die Rezension übersetzt wurde. Wenn die Rezension nicht übersetzt wurde, bleibt dieses Feld leer.

Zeitstempel

Ein Zeitstempel stellt einen von jeder Zeitzone oder jedem lokalen Kalender unabhängigen Zeitpunkt dar, der als Anzahl von Sekunden und Sekundenbruchteilen mit Nanosekunden-Auflösung codiert ist. Die Anzahl bezieht sich auf eine Epoche am 1. Januar 1970 um Mitternacht (UTC).

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit der Unix-Epoche dar.
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Der Wert muss einschließlich zwischen 0 und 999.999.999 liegen.

DeviceMetadata

Merkmale des Geräts des Nutzers.

JSON-Darstellung 
{
  "productName": string,
  "manufacturer": string,
  "deviceClass": string,
  "screenWidthPx": integer,
  "screenHeightPx": integer,
  "nativePlatform": string,
  "screenDensityDpi": integer,
  "glEsVersion": integer,
  "cpuModel": string,
  "cpuMake": string,
  "ramMb": integer
}
Felder
productName

string

Name des Gerätemodells, z.B. Droid
manufacturer

string

Gerätehersteller (z.B. Motorola)
deviceClass

string

Geräteklasse (z.B. Tablet)
screenWidthPx

integer

Bildschirmbreite in Pixeln
screenHeightPx

integer

Bildschirmhöhe in Pixeln
nativePlatform

string

Durch Kommas getrennte Liste der nativen Plattformen (z.B. „arm“, „arm7“)
screenDensityDpi

integer

Bildschirmdichte in DPI
glEsVersion

integer

OpenGL-Version
cpuModel

string

CPU-Modell des Geräts, z.B. „MSM8974“
cpuMake

string

CPU-Hersteller des Geräts, z.B. „Qualcomm“
ramMb

integer

Geräte-RAM in Megabyte, z.B. „2048“

DeveloperComment

Eintrag des Entwicklers aus der Unterhaltung zwischen Nutzer und Entwickler.

JSON-Darstellung 
{
  "text": string,
  "lastModified": {
    object (Timestamp)
  }
}
Felder
text

string

Der Inhalt des Kommentars, d.h. der Antworttext.
lastModified

object (Timestamp)

Der Zeitpunkt, zu dem dieser Kommentar zuletzt aktualisiert wurde.

Methoden

get

 Ruft eine einzelne Rezension ab.

list

 Listet alle Rezensionen auf.

reply

 Antwortet auf eine einzelne Rezension oder aktualisiert eine vorhandene Antwort.

Fehlercodes

Die Vorgänge dieser Ressource geben die folgenden HTTP-Fehlercodes zurück:

Fehlercode Grund Beschreibung Auflösung
400 invalidValue In der Anfrage wurde ein ungültiger Wert angegeben. Dieser Fehler wird häufig zurückgegeben, wenn das Kauf-Token fehlerhaft oder ungültig ist. Korrigieren Sie den ungültigen Feldwert im Anfragetext oder in den Parametern anhand der API-Referenz.
400 required In der Anfrage fehlt ein erforderliches Feld oder ein erforderlicher Parameter. In der API-Dokumentation finden Sie Informationen dazu, ob alle Pflichtfelder und ‑parameter enthalten sind.
403 userInsufficientPermission Der Nutzer hat nicht die erforderlichen Berechtigungen, um den angeforderten Vorgang auszuführen. Prüfen Sie, ob der authentifizierte Nutzer die erforderlichen Berechtigungen in der Google Play Console hat. Weitere Informationen finden Sie unter Dienstkonto verwenden.
404 notFound Die angeforderte Ressource wurde nicht gefunden. Prüfen Sie, ob die Kennzeichnungen (z.B. Kauf-Token, Paketname, Produkt-ID, Abo-ID) korrekt sind.
409 concurrentUpdate Es wurde versucht, ein Objekt zu aktualisieren, das gleichzeitig aktualisiert wird. Wiederholen Sie die Anfrage mit exponentiellem Backoff. Vermeiden Sie gleichzeitige Änderungen an derselben Ressource.
5xx Generic error Allgemeiner Fehler auf dem Google Play-Server. Wiederholen Sie Ihre Anfrage.

Wenn das Problem weiterhin besteht, wenden Sie sich an Ihren Google Play-Kundenbetreuer oder senden Sie eine Supportanfrage. Prüfen Sie im Play-Status-Dashboard, ob bekannte Ausfälle vorliegen.