Method: vitals.excessivewakeuprate.query
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Fragt die Messwerte im Messwert-Set ab.
HTTP-Anfrage
POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/excessiveWakeupRateMetricSet}:query
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
name |
string
Erforderlich. Der Ressourcenname. Format: apps/{app}/excessiveWakeupRateMetricSet
|
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 wird nur die Zeitzone America/Los_Angeles unterstützt.
|
dimensions[] |
string
Optional. Dimensionen, nach denen die Daten 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 zweistelliger ISO 3166-Code (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 :
excessiveWakeupRate (google.type.Decimal): Der Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, die mehr als 10 Wakeups pro Stunde hatten.
excessiveWakeupRate7dUserWeighted (google.type.Decimal): Der gleitende Durchschnittswert von excessiveWakeupRate in den letzten 7 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet.
excessiveWakeupRate28dUserWeighted (google.type.Decimal): Der gleitende Durchschnittswert von excessiveWakeupRate in den letzten 28 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet.
distinctUsers (google.type.Decimal): Die Anzahl der einzelnen Nutzer im Aggregationszeitraum, die als Normalisierungswert für den Messwert excessiveWakeupRate 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 folgt dem AIP-160-Standard und unterstützt das Filtern nach Gleichheit aller Aufschlüsselungsdimensionen.
|
pageSize |
integer
Optional. Die 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. Der einzige unterstützte Wert ist OS_PUBLIC.
|
Antworttext
Antwortnachricht für excessivewakeuprate.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.
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: 2026-04-22 (UTC).
[null,null,["Zuletzt aktualisiert: 2026-04-22 (UTC)."],[],["This outlines how to query metrics from a metric set using a `POST` request to a specified URL. The request includes a resource `name` parameter within the URL. The request body, in JSON format, defines `timelineSpec`, `dimensions`, `metrics`, `filter`, `pageSize`, `pageToken`, and `userCohort`. These specify data aggregation, slicing, metrics to retrieve, data filtering, and result pagination. The response body includes `rows` of data and a `nextPageToken` for subsequent data retrieval, with authorization required via an OAuth scope.\n"]]