Method: vitals.crashrate.query
Fragt die Messwerte im Messwertsatz 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 Zeitachsen-Aggregationsparameter. Unterstützte Aggregationszeiträume:
DAILY: Messwerte werden in Kalenderdatumsintervallen zusammengefasst. Aufgrund von historischen Einschränkungen ist America/Los_Angeles die einzige unterstützte Standardzeitzone.HOURLY: Messwerte werden in stündlichen Intervallen zusammengefasst. Die standardmäßige und nur 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 Form der Kennung ist „deviceBrand/device“, wobei „deviceBrand“ Build.BRAND und „device“ „Build.DEVICE“ entspricht, z.B. google/coral.deviceBrand (string): Die eindeutige Kennung der Gerätemarke des Nutzers, z.B. Google.deviceType (string): der Typ (auch Formfaktor genannt) 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 zweistelliger ISO 3166-Code (z.B. US für die USA).deviceRamBucket (int64): RAM des Geräts in MB in Buckets (3 GB, 4 GB usw.).deviceSocMake (string): Marke des primären System-on-Chips des Geräts, z.B. Samsung ReferenzdeviceSocModel (string): Modell des primären System-on-Chips des Geräts, z.B. „Exynos 2100“. ReferenzdeviceCpuMake (string): Marke 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. MalideviceGpuVersion (string): Version der GPU des Geräts, z.B. T750deviceVulkanVersion (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
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 Durchschnitt von crashRate in den letzten 7 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet.crashRate28dUserWeighted (google.type.Decimal): gleitender Durchschnitt von crashRate in den letzten 28 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet. Wird im Detaillierungsgrad STÜNDLICH nicht unterstützt.userPerceivedCrashRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen während der aktiven Nutzung deiner App mindestens ein Absturz aufgetreten ist (vom Nutzer wahrgenommener Absturz). Eine App gilt als aktiv, wenn sie Aktivitäten anzeigt oder Dienste im Vordergrund ausführt.userPerceivedCrashRate7dUserWeighted (google.type.Decimal): gleitender Durchschnitt von userPerceivedCrashRate in den letzten 7 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet. Wird im Detaillierungsgrad STÜNDLICH nicht unterstützt.userPerceivedCrashRate28dUserWeighted (google.type.Decimal): gleitender Durchschnitt von userPerceivedCrashRate in den letzten 28 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet. Wird im Detaillierungsgrad 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 bei diesem Messwert berücksichtigt, wenn er die App während des Aggregationszeitraums aktiv verwendet hat. Eine App gilt als aktiv, wenn sie Aktivitäten anzeigt oder Dienste im Vordergrund ausführt. Achten Sie darauf, diese Anzahl nicht weiter zu aggregieren, da dies dazu führen kann, dass Nutzer mehrfach gezählt werden. Der Wert wird je nach Größe auf das nächste Vielfache von 10, 100, 1.000 oder 1.000.000 gerundet.
|
filter |
string
Auf Daten anzuwendende Filter. 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. Wenn keine Vorgabe erfolgt, werden maximal 1.000 Zeilen zurückgegeben. Der Maximalwert beträgt 100.000. Werte über 100.000 werden in 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 angegebenen Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.
|
userCohort |
enum (UserCohort)
Nutzeransicht zur Auswahl. 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 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.
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: 2023-11-29 (UTC).
[null,null,["Zuletzt aktualisiert: 2023-11-29 (UTC)."],[[["This endpoint allows you to query crash rate metrics for your app using the Play Developer Reporting API."],["You can specify the timeline, dimensions, metrics, and filters for your query in the request body."],["The response includes rows of data corresponding to your query and a token for pagination if necessary."],["Authorization requires the `https://www.googleapis.com/auth/playdeveloperreporting` OAuth scope."]]],[]]
