Method: vitals.errors.issues.search

Durchsucht alle Fehlerprobleme, in denen Berichte gruppiert wurden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

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

Format: apps/{app}

Suchparameter

Parameter
interval

object (DateTimeInterval)

Optional. Das Datum/Uhrzeit-Intervall, in dem nach Fehlerproblemen gesucht werden soll. Sowohl Start als auch Ende müssen auf die Stunde ausgerichtet sein und UTC als Zeitzone verwenden (oder leer sein, in diesem Fall wird auch UTC verwendet).

Wenn festgelegt, werden nur Fehlerprobleme mit zugehörigen Fehlerberichten zurückgegeben, die im Intervall aufgetreten sind. Wenn nicht angegeben, wird das Standardintervall der letzten 24 Stunden verwendet.

pageSize

integer

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

Falls nicht angegeben, werden maximal 50 Fehlerprobleme zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

pageToken

string

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

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

filter

string

Optional. Ein Auswahlprädikat, um nur eine Teilmenge der Probleme abzurufen. Die Anzahl in den zurückgegebenen Fehlerproblemen spiegelt nur Vorkommen wider, die mit dem Filter übereinstimmen.

Grundlagen zum Filtern finden Sie unter AIP-160.

** Unterstützte Feldnamen** :

  • apiLevel: Entspricht nur Fehlerproblemen, die in den angeforderten Android-Versionen aufgetreten sind (angegeben als numerisches API-Level). Beispiel: apiLevel = 28 OR apiLevel = 29.
  • versionCode: Entspricht nur Fehlerproblemen, 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 Fehlerproblemen, die bei den angeforderten Gerätetypen aufgetreten sind. Beispiel: deviceType = "PHONE".
  • errorIssueType: Entspricht nur Fehlerproblemen der angeforderten Typen. Gültige Kandidaten: CRASH, ANR, NON_FATAL. Beispiel: errorIssueType = CRASH OR errorIssueType = ANR.
  • appProcessState: Entspricht Fehlerproblemen im Prozessstatus einer App, die angibt, 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 Fehlerproblemen, die von Nutzern wahrgenommen werden. Es wird von keinen Operatoren begleitet. Beispiel: isUserPerceived.

** Unterstützte Operatoren** :

  • Vergleichsoperatoren: Der einzige unterstützte Vergleichsoperator ist 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 OR Operator wird nur zum Erstellen von Disjunktionen unterstützt, die auf dasselbe Feld angewendet werden. versionCode = 123 OR errorIssueType = ANR ist beispielsweise kein gültiger Filter.

** 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)

orderBy

string

Optional. Gibt ein Feld an, das zum Sortieren der Ergebnisse verwendet wird.

** Unterstützte Dimensionen** :

  • errorReportCount: Sortiert Probleme nach der Anzahl der Fehlerberichte.
  • distinctUsers: Sortiert Probleme nach der Anzahl der eindeutigen betroffenen Nutzer.

** Unterstützte Vorgänge** :

  • asc für aufsteigende Reihenfolge.
  • desc für absteigende Reihenfolge.

Format: Ein Feld und ein Vorgang, z.B. errorReportCount desc

Hinweis:Derzeit wird nur ein Feld gleichzeitig unterstützt.

sampleErrorReportLimit

integer

Optional. Anzahl der Fehlerberichte, die pro Fehlerproblem zurückgegeben werden sollen. Wenn nicht angegeben, wird 0 verwendet. Hinweis:Derzeit werden nur 0 und 1 unterstützt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort mit einer paginierten Liste von Problemen, die der Anfrage entsprechen.

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

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

object (ErrorIssue)

Gefundene Fehlerprobleme.

nextPageToken

string

Fortsetzungstoken zum Abrufen der nächsten Datenseite.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.