Method: vitals.errors.reports.search
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Durchsucht alle für eine App eingegangenen 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 angibt, für welche Anwendung sie empfangen wurden. Format: apps/{app}
|
Abfrageparameter
Parameter |
interval |
object (DateTimeInterval )
Der Zeitraum, in dem nach Fehlerberichten gesucht werden soll. Sowohl Start als auch Ende 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 im Intervall aufgetreten sind. Wenn nichts angegeben ist, wird das Standardintervall der letzten 24 Stunden verwendet.
|
pageSize |
integer
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
Ein Seitentoken, das von einem vorherigen reports.search -Aufruf empfangen wurde. Geben Sie diese 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
Ein Auswahlprädikat, um nur eine Teilmenge der Berichte abzurufen. Grundlegende Informationen zum Filtern finden Sie unter AIP-160. ** Unterstützte Feldnamen:**
apiLevel : Entspricht nur Fehlerberichten, die in den angeforderten Android-Versionen (als numerisches API-Level angegeben) aufgetreten sind. 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 Fehlern, die bei den angeforderten Gerätemarken aufgetreten sind. Beispiel: `deviceBrand = "Google"`.
deviceType : Entspricht Fehlerberichten, die auf den angeforderten Gerätetypen aufgetreten sind. Beispiel: deviceType = "PHONE" .
errorIssueType : Es werden nur Fehlerberichte der angeforderten Typen berücksichtigt. Zulässige Werte: CRASH , ANR , NON_FATAL . Beispiel: errorIssueType = CRASH OR errorIssueType = ANR .
errorIssueId : Entspricht nur Fehlerberichten, die zu den angeforderten Fehler-Issue-IDs gehören. Beispiel: errorIssueId = 1234 OR errorIssueId = 4567 .
errorReportId : Gleicht Fehlerberichte mit der angeforderten Fehlerbericht-ID ab. Beispiel: errorReportId = 1234 OR errorReportId = 4567 .
appProcessState : Entspricht Fehlerberichten zum Prozessstatus einer App. Gibt an, ob eine App im Vordergrund (für den Nutzer sichtbar) oder im Hintergrund ausgeführt wird. Gültige Kandidaten: FOREGROUND , BACKGROUND . Beispiel: appProcessState = FOREGROUND .
isUserPerceived : Entspricht Fehlerberichten, die Nutzer wahrnehmen. Es wird nicht von 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: Mit den logischen Operatoren
AND und OR lassen sich komplexe Filter in konjunktiver Normalform (CNF) erstellen, d.h. Konjunktionen von Disjunktionen. Der Operator OR hat Vorrang vor AND . Daher sind beim Erstellen von CNF keine Klammern erforderlich.
Der Operator OR wird nur zum Erstellen von Disjunktionen unterstützt, die für dasselbe Feld gelten, 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.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003eSearches all error reports received for a specific application within a specified timeframe.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by various criteria, such as Android version, app version code, device model, and error type.\u003c/p\u003e\n"],["\u003cp\u003eReturns a paginated list of error reports matching the search query, including details about each error.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This outlines how to search for app error reports via an HTTP GET request to `https://playdeveloperreporting.googleapis.com/v1beta1/{parent=apps/*}/errorReports:search`. The `parent` path parameter specifies the app. Query parameters include `interval` for date ranges, `pageSize` for report limits (max 100), `pageToken` for pagination, and `filter` for narrowing results by criteria like `apiLevel`, `versionCode`, or `errorIssueType`. The request body is empty, and the response body contains a paginated list of `errorReports` and a `nextPageToken`.\n"],null,[]]