Method: vitals.crashrate.query

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:

  • OS_PUBLIC, um Daten aus allen öffentlich veröffentlichten Android-Versionen auszuwählen. Das ist die Standardeinstellung. Unterstützt alle oben genannten Dimensionen.
  • APP_TESTERS: Damit werden Daten von Nutzern ausgewählt, die sich als Tester angemeldet haben. Unterstützt alle oben genannten Dimensionen.
  • OS_BETA, um nur Daten aus Android-Betaversionen auszuwählen und Daten aus veröffentlichten Android-Versionen auszuschließen. Nur die folgenden Dimensionen werden unterstützt:
  • versionCode (int64): Version der App, die auf dem Gerät des Nutzers ausgeführt wurde.

  • osBuild (string): Betriebssystem-Build des Geräts des Nutzers, z.B. „T1B2.220916.004“.

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.