Method: vitals.stuckbackgroundwakelockrate.query

Fragt die Messwerte im Messwertsatz ab.

HTTP-Anfrage

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/stuckBackgroundWakelockRateMetricSet}:query

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname

Format: apps/{app}/stuckBackgroundWakelockRateMetricSet

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 wird nur die Zeitzone America/Los_Angeles unterstützt.
dimensions[]

string

Dimensionen, nach denen die Daten segmentiert 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 Referenz
  • deviceSocModel (string): Modell des primären System-on-Chips des Geräts, z.B. „Exynos 2100“. Referenz
  • deviceCpuMake (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. 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

Zu aggregierende Messwerte.

Unterstützte Messwerte:

  • stuckBgWakelockRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen ein Wakelock länger als eine Stunde im Hintergrund gehalten wurde.
  • stuckBgWakelockRate7dUserWeighted (google.type.Decimal): gleitender Durchschnitt von stuckBgWakelockRate in den letzten 7 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet.
  • stuckBgWakelockRate28dUserWeighted (google.type.Decimal): gleitender Durchschnitt von stuckBgWakelockRate in den letzten 28 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet.
  • distinctUsers (google.type.Decimal): Anzahl der einzelnen Nutzer im Aggregationszeitraum, die als Normalisierungswert für den Messwert stuckBgWakelockRate verwendet wurden. Bei diesem Messwert werden Nutzer gezählt, wenn sie mit der App auf dem Gerät gearbeitet haben, also nicht nur aktiv im Vordergrund, sondern auch im Hintergrund arbeiten. 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 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 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:

  • OS_PUBLIC Daten aus allen öffentlich veröffentlichten Android-Versionen auswählen Das ist die Standardeinstellung. Unterstützt alle oben genannten Dimensionen.
  • APP_TESTERS Zur Auswahl von Daten von Nutzern, die sich als Tester entschieden haben. Unterstützt alle oben genannten Dimensionen.
  • OS_BETA Nur Daten aus Android-Betaversionen auswählen, Daten aus veröffentlichten Android-Versionen ausschließ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 Nutzergeräts, z.B. „T1B2.220916.004“.

Antworttext

Antwortnachricht für stuckbackgroundwakelockrate.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.