Method: vitals.crashrate.query

Fragt die Messwerte im Messwert-Set 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)

Optional. Spezifikation der Parameter für die Zeitachsenaggregation.

Unterstützte Aggregationszeiträume :

  • DAILY: Messwerte werden in Intervallen von Kalendertagen zusammengefasst. Aus historischen Gründen ist America/Los_Angeles die Standard- und einzige unterstützte Zeitzone.
  • HOURLY: Messwerte werden in stündlichen Intervallen zusammengefasst. Die Standard- und einzige unterstützte Zeitzone ist UTC.
dimensions[]

string

Optional. 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): Die Version der App, die auf dem Gerät des Nutzers ausgeführt wurde.
  • deviceModel (string): Die 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): 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 2-Buchstaben-Code nach ISO 3166 (z.B. „US“ für die USA).
  • deviceRamBucket (int64): Der RAM des Geräts in MB, in Buckets (3 GB, 4 GB usw.).
  • deviceSocMake (string): Der Hersteller des primären System-on-a-Chip des Geräts, z.B. „Samsung“. Referenz
  • deviceSocModel (string): Das Modell des primären System-on-a-Chip des Geräts, z.B. „Exynos 2100“. Referenz
  • deviceCpuMake (string): Der Hersteller der CPU des Geräts, z.B. „Qualcomm“.
  • deviceCpuModel (string): Das Modell der CPU des Geräts, z.B. „Kryo 240“.
  • deviceGpuMake (string): Der Hersteller der GPU des Geräts, z.B. „ARM“.
  • deviceGpuModel (string): Das Modell der GPU des Geräts, z.B. „Mali“.
  • deviceGpuVersion (string): Die Version der GPU des Geräts, z.B. „T750“.
  • deviceVulkanVersion (string): Die Vulkan-Version des Geräts, z.B. „4198400“.
  • deviceGlEsVersion (string): Die OpenGL ES-Version des Geräts, z.B. „196610“.
  • deviceScreenSize (string): Die Bildschirmgröße des Geräts, z.B. „NORMAL“, „LARGE“.
  • deviceScreenDpi (string): Die Bildschirmdichte des Geräts, z.B. „mdpi“, „hdpi“.
metrics[]

string

Optional. Messwerte, die zusammengefasst werden sollen.

Unterstützte Messwerte :

  • crashRate (google.type.Decimal): Der Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen mindestens ein Absturz aufgetreten ist.
  • crashRate7dUserWeighted (google.type.Decimal): Der gleitende Durchschnittswert 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): Der gleitende Durchschnittswert von crashRate in den letzten 28 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet. Wird bei stündlicher Granularität nicht unterstützt.
  • userPerceivedCrashRate (google.type.Decimal): Der 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 verwendet, wenn eine Aktivität angezeigt oder ein Dienst im Vordergrund ausgeführt wird.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Der gleitende Durchschnittswert von userPerceivedCrashRate in den letzten 7 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet. Wird bei stündlicher Granularität nicht unterstützt.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Der gleitende Durchschnittswert von userPerceivedCrashRate in den letzten 28 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet. Wird bei stündlicher Granularität nicht unterstützt.
  • distinctUsers (google.type.Decimal): Die Anzahl der einzelnen Nutzer im Aggregationszeitraum, die als Normalisierungswert für die Messwerte crashRate und userPerceivedCrashRate verwendet wurden. Ein Nutzer wird in diesem Messwert gezählt, wenn er die App im Aggregationszeitraum aktiv verwendet hat. Eine App gilt als aktiv verwendet, wenn eine Aktivität angezeigt oder ein Dienst im Vordergrund ausgeführt wird. Diese Anzahl darf nicht weiter zusammengefasst werden, da Nutzer sonst möglicherweise mehrmals 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

Optional. Filter, die auf die 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 liegt bei 100.000. Alle Werte darüber werden implizit in 100.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. Die auszuwählende Nutzeransicht. Die Ausgabedaten entsprechen der ausgewählten Ansicht.

Unterstützte Werte :

  • OS_PUBLIC: Daten aus allen öffentlich veröffentlichten Android-Versionen auswählen. Das ist die Standardeinstellung. Unterstützt alle oben genannten Dimensionen.
  • APP_TESTERS: Daten von Nutzern auswählen, die sich als Tester registriert haben. Unterstützt alle oben genannten Dimensionen.
  • OS_BETA: Nur Daten aus Android-Betaversionen auswählen, Daten aus veröffentlichten Android-Versionen ausschließen. Es werden nur die folgenden Dimensionen unterstützt:

  • versionCode (int64): Die Version der App, die auf dem Gerät des Nutzers ausgeführt wurde.

  • osBuild (string): Der OS-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.