Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.
Method: vitals.crashrate.query
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Fragt die Messwerte im Messwertset ab.
HTTP-Anfrage
POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/crashRateMetricSet}:query
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
name |
string
Erforderlich. Der Ressourcenname. Format: apps/{app}/crashRateMetricSet
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
{
"timelineSpec": {
object (TimelineSpec)
},
"dimensions": [
string
],
"metrics": [
string
],
"filter": string,
"pageSize": integer,
"pageToken": string,
"userCohort": enum (UserCohort)
} |
| Felder |
timelineSpec |
object (TimelineSpec)
Optional. Spezifikation der Parameter für die Zeitachsenaggregation. Unterstützte Aggregationszeiträume:
DAILY: Messwerte werden in Kalenderdatumsintervallen zusammengefasst. Aus historischen Gründen ist die Standardzeitzone und die einzige unterstützte Zeitzone America/Los_Angeles.
HOURLY: Messwerte werden in stündlichen Intervallen aggregiert. Die standardmäßige und einzige unterstützte Zeitzone ist UTC.
|
dimensions[] |
string
Optional. Dimensionen, nach denen die Messwerte aufgeteilt werden sollen. Unterstützte Dimensionen:
apiLevel (string): das API-Level von Android, das auf dem Gerät des Nutzers ausgeführt wurde, z.B. 26.
versionCode (int64): Version der App, die auf dem Gerät des Nutzers ausgeführt wurde.
deviceModel (string): eindeutige Kennung des Gerätemodells des Nutzers. Die Kennung hat das Format „deviceBrand/device“, wobei „deviceBrand“ „Build.BRAND“ und „device“ „Build.DEVICE“ entspricht, z.B. „google/coral“.
deviceBrand (string): eindeutige Kennung der Gerätemarke des Nutzers, z.B. google.
deviceType (string): Der Typ (auch als Formfaktor bezeichnet) des Geräts des Nutzers, z.B. PHONE.
countryCode (string): Das Land oder die Region des Geräts des Nutzers basierend auf seiner IP-Adresse, dargestellt als ISO-3166-Code mit zwei Buchstaben (z.B. US für die USA).
deviceRamBucket (int64): RAM des Geräts in MB, in Buckets (z. B. 1024 für 1–1,5 GB, 4096 für 4–6 GB).
deviceSocMake (string): Hersteller des primären System-on-Chip des Geräts, z.B. Samsung. Referenz
deviceSocModel (string): Modell des primären System-on-Chip des Geräts, z.B. „Exynos 2100“. Referenz
deviceCpuMake (string): Hersteller der CPU des Geräts, z.B. Qualcomm.
deviceCpuModel (string): Modell der CPU des Geräts, z.B. „Kryo 240“.
deviceGpuMake (string): Hersteller der GPU des Geräts, z.B. ARM.
deviceGpuModel (string): Modell der GPU des Geräts, z.B. Mali.
deviceGpuVersion (string): Version der GPU des Geräts, z.B. T750.
deviceVulkanVersion (string): Vulkan-Version des Geräts, z.B. „4198400“.
deviceGlEsVersion (string): OpenGL ES-Version des Geräts, z.B. „196610“.
deviceScreenSize (string): Bildschirmgröße des Geräts, z.B. NORMAL, LARGE.
deviceScreenDpi (string): Pixeldichte des Geräts, z.B. mdpi, hdpi.
|
metrics[] |
string
Optional. Zu aggregierende Messwerte. Unterstützte Messwerte:
crashRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen mindestens ein Absturz aufgetreten ist.
crashRate7dUserWeighted (google.type.Decimal): Gleitender Durchschnittswert von crashRate in den letzten 7 Tagen. Die täglichen Werte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet.
crashRate28dUserWeighted (google.type.Decimal): Gleitender Durchschnittswert von crashRate in den letzten 28 Tagen. Die täglichen Werte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet. Wird bei der Granularität STÜNDLICH nicht unterstützt.
userPerceivedCrashRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen mindestens ein Absturz aufgetreten ist, während sie deine App aktiv verwendet haben (ein vom Nutzer wahrgenommener Absturz). Eine App gilt als aktiv, wenn sie eine Aktivität anzeigt oder einen Dienst im Vordergrund ausführt.
userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Gleitender Durchschnittswert von userPerceivedCrashRate in den letzten 7 Tagen. Die täglichen Werte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet. Wird bei der Granularität STÜNDLICH nicht unterstützt.
userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Gleitender Durchschnittswert von userPerceivedCrashRate in den letzten 28 Tagen. Die täglichen Werte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet. Wird bei der Granularität STÜNDLICH nicht unterstützt.
distinctUsers (google.type.Decimal): Anzahl der einzelnen Nutzer im Aggregationszeitraum, die als Normalisierungswert für die Messwerte crashRate und userPerceivedCrashRate verwendet wurden. Ein Nutzer wird in diesem Messwert berücksichtigt, wenn er die App während des Aggregationszeitraums aktiv verwendet hat. Eine App gilt als aktiv, wenn sie eine Aktivität anzeigt oder einen Dienst im Vordergrund ausführt. Diese Anzahl darf nicht weiter aggregiert werden, da Nutzer sonst möglicherweise mehrfach gezählt werden. Der Wert wird je nach Größenordnung auf das nächste Vielfache von 10, 100, 1.000 oder 1.000.000 gerundet.
|
filter |
string
Optional. Filter, die auf Daten angewendet werden sollen. Der Filterausdruck entspricht dem AIP-160-Standard und unterstützt das Filtern nach Gleichheit aller Aufschlüsselungsdimensionen.
|
pageSize |
integer
Optional. Maximale Größe der zurückgegebenen Daten. Wenn nicht angegeben, werden maximal 1.000 Zeilen zurückgegeben. Der Höchstwert beträgt 10.000. Werte über 10.000 werden implizit auf 10.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.
|
userCohort |
enum (UserCohort)
Optional. Nutzeransicht, die ausgewählt werden soll. Die Ausgabedaten entsprechen der ausgewählten Ansicht. Unterstützte Werte:
|
Antworttext
Antwortnachricht für crashrate.query.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"rows": [
{
object (MetricsRow)
}
],
"nextPageToken": string
} |
| Felder |
rows[] |
object (MetricsRow)
Zurückgegebene Datenzeilen.
|
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.
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: 2026-10-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2026-10-26 (UTC)."],[],["This document details how to query crash rate metrics using a POST request to `https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/crashRateMetricSet}:query`. The request requires a `name` path parameter. The request body specifies `timelineSpec`, `dimensions` (e.g., `apiLevel`, `deviceModel`), `metrics` (e.g., `crashRate`, `distinctUsers`), optional `filter`, `pageSize`, `pageToken`, and `userCohort`. The response contains `rows` of metric data and a `nextPageToken` for pagination. Requires OAuth scope `https://www.googleapis.com/auth/playdeveloperreporting`.\n"]]