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/v1alpha1/{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 )
Spezifikation der Parameter für die Zeitachsenaggregation. Unterstützte Aggregationszeiträume:
DAILY : Messwerte werden in Kalenderdatumsintervallen zusammengefasst. Aus historischen Gründen ist die Standard- und einzige unterstützte Zeitzone America/Los_Angeles .
HOURLY : Messwerte werden in stündlichen Intervallen zusammengefasst. Die Standardzeitzone und einzige unterstützte Zeitzone ist UTC .
|
dimensions[] |
string
Dimensionen, nach denen die Messwerte aufgeschlüsselt 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 2-Buchstaben-Code gemäß ISO 3166 (z.B. „US“ für die USA).
deviceRamBucket (int64 ): RAM des Geräts in MB, in Gruppen (3 GB, 4 GB usw.).
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 ): Marke 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, GROSS.
deviceScreenDpi (string ): Bildschirmdichte des Geräts, z.B. „mdpi“, „hdpi“.
|
metrics[] |
string
Messwerte, die aggregiert werden sollen. 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 Tageswerte werden nach der Anzahl der einzelnen Nutzer für den jeweiligen Tag gewichtet.
crashRate28dUserWeighted (google.type.Decimal ): Gleitender Durchschnittswert von crashRate in den letzten 28 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den jeweiligen Tag gewichtet. Wird bei stündlicher Granularität nicht unterstützt.
userPerceivedCrashRate (google.type.Decimal ): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen mindestens ein Absturz aufgetreten ist, während sie Ihre App aktiv verwendet haben (ein vom Nutzer wahrgenommener Absturz). Eine App gilt als aktiv genutzt, 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 Tageswerte werden nach der Anzahl der einzelnen Nutzer für den jeweiligen Tag gewichtet. Wird bei stündlicher Granularität nicht unterstützt.
userPerceivedCrashRate28dUserWeighted (google.type.Decimal ): Gleitender Durchschnittswert von userPerceivedCrashRate in den letzten 28 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den jeweiligen Tag gewichtet. Wird bei stündlicher Granularität nicht unterstützt.
distinctUsers (google.type.Decimal ): Anzahl der eindeutigen 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 genutzt, 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 seiner Größenordnung auf das nächste Vielfache von 10, 100, 1.000 oder 1.000.000 gerundet.
|
filter |
string
Filter, die auf Daten angewendet werden sollen. Der Filterausdruck entspricht dem AIP-160 und unterstützt das Filtern nach Gleichheit aller Aufschlüsselungsdimensionen.
|
pageSize |
integer
Maximale Größe der zurückgegebenen Daten. Falls nicht angegeben, werden maximal 1.000 Zeilen zurückgegeben. Der Höchstwert beträgt 100.000. Werte über 100.000 werden implizit auf 100.000 umgewandelt.
|
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 bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
|
userCohort |
enum (UserCohort )
Nutzeransicht zum Auswählen. 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
Fortsetzungs-Token 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: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003eThis endpoint allows you to query crash rate metrics for your app using the Play Developer Reporting API.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify the timeline, dimensions, metrics, and filters for your query in the request body.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes rows of data corresponding to your query and a token for pagination if necessary.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/playdeveloperreporting\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This outlines how to query metrics in a crash rate metric set via a POST request to a specific URL. The request body requires parameters like `timelineSpec` for aggregation periods, `dimensions` to segment metrics (e.g., `apiLevel`, `deviceModel`), and `metrics` to define data points (e.g., `crashRate`). Filters, `pageSize`, `pageToken`, and `userCohort` options are available. The response includes `rows` of metric data and `nextPageToken` for pagination, and it uses OAuth 2.0 authorization.\n"],null,[]]