Method: vitals.stuckbackgroundwakelockrate.query

Fragt die Messwerte im Messwert-Set ab.

HTTP-Anfrage

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{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)

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 die einzige unterstützte Zeitzone America/Los_Angeles.
dimensions[]

string

Optional. Dimensionen, nach denen die Daten aufgeschlüsselt werden sollen.

Unterstützte Dimensionen :

  • apiLevel (string): Die API-Ebene von Android, die 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 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 gemäß ISO 3166 (z.B. „US“ für die USA).
  • deviceRamBucket (int64): RAM des Geräts in MB, in Buckets (3 GB, 4 GB usw.).
  • deviceSocMake (string): Hersteller des primären System-on-a-Chip des Geräts, z.B. „Samsung“. Referenz
  • deviceSocModel (string): Modell des primären System-on-a-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): Bildschirmdichte des Geräts, z.B. „mdpi“, „hdpi“.
metrics[]

string

Optional. Messwerte, die zusammengefasst werden sollen.

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 Durchschnittswert 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 Durchschnittswert 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. Ein Nutzer wird in diesem Messwert gezählt, wenn seine App auf dem Gerät aktiv war, d.h. nicht nur bei aktiver Nutzung im Vordergrund, sondern auch bei Hintergrundaktivitäten. Diese Anzahl darf nicht weiter zusammengefasst werden, da Nutzer sonst möglicherweise mehrfach gezählt werden. Der Wert wird auf das nächste Vielfache von 10, 100, 1.000 oder 1.000.000 gerundet, je nach Größe des Werts.
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. Auszuwählende Nutzeransicht. Die Ausgabedaten entsprechen der ausgewählten Ansicht. Der einzige unterstützte Wert ist OS_PUBLIC.

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

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.