Method: vitals.errors.reports.search

Durchsucht alle für eine App empfangenen Fehlerberichte.

HTTP-Anfrage

GET https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/errorReports:search

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Übergeordnete Ressource der Berichte, die die Anwendung angibt, für die sie empfangen wurden.

Format: apps/{app}

Suchparameter

Parameter
interval

object (DateTimeInterval)

Optional. Der Zeitraum, in dem nach Fehlerberichten gesucht werden soll. Sowohl Start- als auch Endzeitpunkt müssen auf die Stunde ausgerichtet sein und die Zeitzone UTC verwenden (oder leer sein, in diesem Fall wird auch UTC verwendet).

Wenn festgelegt, werden nur Fehlerberichte zurückgegeben, die in diesem Zeitraum aufgetreten sind. Wenn nicht angegeben, wird der Standardzeitraum der letzten 24 Stunden verwendet.
pageSize

integer

Optional. Die maximale Anzahl der zurückzugebenden Berichte. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.

Wenn nicht angegeben, werden maximal 50 Berichte zurückgegeben. Der Höchstwert beträgt 100. Werte über 100 werden implizit auf 100 umgewandelt.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen reports.search-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für reports.search bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
filter

string

Optional. Ein Auswahlprädikat, um nur eine Teilmenge der Berichte abzurufen.

Grundlagen zum Filtern finden Sie unter AIP-160.

** Unterstützte Feldnamen **

  • apiLevel: Entspricht nur Fehlerberichten, die in den angeforderten Android-Versionen aufgetreten sind (angegeben als numerisches API-Level). Beispiel: apiLevel = 28 OR apiLevel = 29.
  • versionCode: Entspricht nur Fehlerberichten, die in den angeforderten App-Versionscodes aufgetreten sind. Beispiel: versionCode = 123 OR versionCode = 456.
  • deviceModel: Entspricht Fehlerproblemen, die auf den angeforderten Geräten aufgetreten sind. Beispiel: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand: Entspricht Fehlerproblemen, die bei den angeforderten Gerätemarken aufgetreten sind. Beispiel: `deviceBrand = "Google".
  • deviceType: Entspricht Fehlerberichten, die bei den angeforderten Gerätetypen aufgetreten sind. Beispiel: deviceType = "PHONE".
  • errorIssueType: Entspricht nur Fehlerberichten der angeforderten Typen. Gültige Kandidaten: CRASH, ANR, NON_FATAL. Beispiel: errorIssueType = CRASH OR errorIssueType = ANR.
  • errorIssueId: Entspricht nur Fehlerberichten, die zu den angeforderten Fehlerproblem-IDs gehören. Beispiel: errorIssueId = 1234 OR errorIssueId = 4567.
  • errorReportId: Entspricht Fehlerberichten mit der angeforderten Fehlerbericht-ID. Beispiel: errorReportId = 1234 OR errorReportId = 4567.
  • appProcessState: Entspricht Fehlerberichten zum Prozessstatus einer App, die angeben, ob eine App im Vordergrund (für Nutzer sichtbar) oder im Hintergrund ausgeführt wird. Gültige Kandidaten: FOREGROUND, BACKGROUND. Beispiel: appProcessState = FOREGROUND.
  • isUserPerceived: Entspricht Fehlerberichten, die von Nutzern wahrgenommen werden. Es wird kein Operator verwendet. Beispiel: isUserPerceived.

** Unterstützte Operatoren **

  • Vergleichsoperatoren: Der einzige unterstützte Vergleichsoperator ist die Gleichheit. Das gefilterte Feld muss auf der linken Seite des Vergleichs stehen.
  • Logische Operatoren: Die logischen Operatoren AND und OR können verwendet werden, um komplexe Filter in konjunktiver Normalform (CNF) zu erstellen, d.h. Konjunktionen von Disjunktionen. Der Operator OR hat Vorrang vor AND. Daher ist die Verwendung von Klammern beim Erstellen von CNF nicht erforderlich.

Der Operator OR wird nur unterstützt, um Disjunktionen zu erstellen, die auf dasselbe Feld angewendet werden, z.B. versionCode = 123 OR versionCode = ANR. Der Filterausdruck versionCode = 123 OR errorIssueType = ANR ist ungültig.

** Beispiele **

Einige gültige Filterausdrücke: * versionCode = 123 AND errorIssueType = ANR * versionCode = 123 AND errorIssueType = OR errorIssueType = CRASH * versionCode = 123 AND (errorIssueType = OR errorIssueType = CRASH)

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort mit einer paginierten Liste von Fehlerberichten, die der Suchanfrage entsprechen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "errorReports": [
    {
      object (ErrorReport)
    }
  ],
  "nextPageToken": string
}
Felder
errorReports[]

object (ErrorReport)

Gefundene Fehlerberichte.
nextPageToken

string

Seitentoken zum Abrufen der nächsten Seite mit Berichten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/playdeveloperreporting

Weitere Informationen finden Sie unter OAuth 2.0 Overview.