Method: vitals.errors.issues.search

Durchsucht alle Fehlerprobleme, in denen Berichte gruppiert wurden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Übergeordnete Ressource des Fehlers, unter Angabe der Anwendung, für die sie empfangen wurden.

Format: apps/{app}

Abfrageparameter

Parameter
interval

object (DateTimeInterval)

Das Datums-/Uhrzeitintervall für Suchfehlerprobleme. Start und Ende müssen auf Stunden ausgerichtet sein und UTC als Zeitzone verwenden oder leer sein. In diesem Fall wird auch UTC verwendet.

Wenn festgelegt, werden nur Fehler mit zugehörigen Fehlerberichten zurückgegeben, die im Intervall aufgetreten sind. Wenn keine Vorgabe erfolgt, wird das Standardintervall der letzten 24 Stunden verwendet.

pageSize

integer

Die maximale Anzahl der Fehlerprobleme, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.

Wenn keine Angabe erfolgt, werden höchstens 50 Fehler zurückgegeben. Der Maximalwert beträgt 1.000. Für Werte über 1.000 wird 1.000 erzwungen.

pageToken

string

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

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

filter

string

Ein Auswahlprädikat zum Abrufen nur eines Teils der Probleme. Die Anzahl der zurückgegebenen Fehlerprobleme bezieht sich nur auf Vorkommnisse, die dem Filter entsprechen.

Informationen zu den Grundlagen der Filterung finden Sie unter AIP-160.

** Unterstützte Feldnamen:**

  • apiLevel: Weist nur Fehlerprobleme zu, die in den angeforderten Android-Versionen (angegeben als numerisches API-Level) aufgetreten sind. Beispiel: apiLevel = 28 OR apiLevel = 29.
  • versionCode: Weist nur Fehler in den angeforderten App-Versionscodes zu. Beispiel: versionCode = 123 OR versionCode = 456.
  • deviceModel: Findet Fehler, die auf den angeforderten Geräten aufgetreten sind. Beispiel: deviceModel = "google/walleye" OR deviceModel = "google/marlin".
  • deviceBrand: Weist nach Fehlerproblemen zu, die bei den angeforderten Gerätemarken aufgetreten sind. Beispiel: `deviceBrand = "Google".
  • deviceType: Weist Fehlerprobleme zu, die in den angeforderten Gerätetypen aufgetreten sind. Beispiel: deviceType = "PHONE".
  • errorIssueType: Weist nur Fehlerprobleme der angeforderten Typen zu. Gültige Kandidaten: CRASH, ANR. Beispiel: errorIssueType = CRASH OR errorIssueType = ANR.
  • appProcessState: Weist Fehler mit dem Prozessstatus einer App zu und gibt an, ob eine App im Vordergrund (für Nutzer sichtbar) oder im Hintergrund ausgeführt wird. Gültige Kandidaten: FOREGROUND, BACKGROUND. Beispiel: appProcessState = FOREGROUND.
  • isUserPerceived: Weist Fehlerprobleme zu, die vom Nutzer wahrgenommen werden. Sie wird von keinem Operator begleitet. Beispiel: isUserPerceived.

** Unterstützte Operatoren:**

  • Vergleichsoperatoren: Der einzige unterstützte Vergleichsoperator ist der Gleichheitsoperator. Das gefilterte Feld muss auf der linken Seite des Vergleichs angezeigt werden.
  • Logische Operatoren: Die logischen Operatoren AND und OR können verwendet werden, um komplexe Filter in einer konjunktiven Normalform (CNF) zu erstellen, d.h. Konjunktionen von Disjunktionen. Der Operator OR hat Vorrang vor AND, sodass bei der Erstellung von CNF keine Klammern verwendet werden müssen.

Der Operator OR wird nur zum Erstellen von Disjunktionen unterstützt, die für dasselbe Feld gelten, z.B. versionCode = 123 OR errorIssueType = ANR ist 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

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

** Unterstützte Abmessungen:**

  • errorReportCount: Bestellprobleme nach Anzahl der Fehlerberichte.
  • distinctUsers: Bestellprobleme nach Anzahl der einzelnen 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 auf einmal 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 ErrorIssues.

nextPageToken

string

Fortsetzungs-Token zum Abrufen der nächsten Seite mit Daten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.