Method: vitals.stuckbackgroundwakelockrate.query

Interroge les métriques dans l'ensemble de métriques.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de la ressource.

Format: apps/{app}/stuckBackgroundWakelockRateMetricSet

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Champs
timelineSpec

object (TimelineSpec)

Facultatif. Spécification des paramètres d'agrégation de la chronologie.

Périodes d'agrégation acceptées :

  • DAILY : les métriques sont agrégées par intervalles de dates calendaires. En raison de contraintes historiques, le seul fuseau horaire accepté est America/Los_Angeles.
dimensions[]

string

Facultatif. Dimensions selon lesquelles segmenter les données.

Dimensions acceptées :

  • apiLevel (string) : niveau d'API Android exécuté sur l'appareil de l'utilisateur (par exemple, 26).
  • versionCode (int64) : version de l'application exécutée sur l'appareil de l'utilisateur.
  • deviceModel (string) : identifiant unique du modèle d'appareil de l'utilisateur. Le format de l'identifiant est « deviceBrand/device », où deviceBrand correspond à Build.BRAND et device à Build.DEVICE (par exemple, google/coral).
  • deviceBrand (string) : identifiant unique de la marque de l'appareil de l'utilisateur (par exemple, google).
  • deviceType (string) : type (également appelé facteur de forme) de l'appareil de l'utilisateur (par exemple, PHONE).
  • countryCode (string) : pays ou région de l'appareil de l'utilisateur en fonction de son adresse IP, représenté par un code ISO-3166 à deux lettres (par exemple, US pour les États-Unis).
  • deviceRamBucket (int64) : RAM de l'appareil, en Mo, par buckets (3 Go, 4 Go, etc.).
  • deviceSocMake (string) : fabricant du système sur puce principal de l'appareil (par exemple, Samsung). Référence
  • deviceSocModel (string) : modèle du système sur puce principal de l'appareil (par exemple, "Exynos 2100"). Référence
  • deviceCpuMake (string) : fabricant du processeur de l'appareil (par exemple, Qualcomm).
  • deviceCpuModel (string) : modèle du processeur de l'appareil (par exemple, "Kryo 240").
  • deviceGpuMake (string) : fabricant du processeur graphique de l'appareil (par exemple, ARM).
  • deviceGpuModel (string) : modèle du processeur graphique de l'appareil (par exemple, Mali).
  • deviceGpuVersion (string) : version du processeur graphique de l'appareil (par exemple, T750).
  • deviceVulkanVersion (string) : version Vulkan de l'appareil (par exemple, "4198400").
  • deviceGlEsVersion (string) : version OpenGL ES de l'appareil (par exemple, "196610").
  • deviceScreenSize (string) : taille de l'écran de l'appareil (par exemple, NORMAL, LARGE).
  • deviceScreenDpi (string) : densité d'écran de l'appareil (par exemple, mdpi, hdpi).
metrics[]

string

Facultatif. Métriques à agréger.

Métriques acceptées :

  • stuckBgWakelockRate (google.type.Decimal) : pourcentage d'utilisateurs distincts au cours de la période d'agrégation qui ont maintenu un wakelock en arrière-plan pendant plus d'une heure.
  • stuckBgWakelockRate7dUserWeighted (google.type.Decimal) : valeur moyenne glissante de stuckBgWakelockRate au cours des sept derniers jours. Les valeurs quotidiennes sont pondérées par le nombre d'utilisateurs distincts pour la journée.
  • stuckBgWakelockRate28dUserWeighted (google.type.Decimal) : valeur moyenne glissante de stuckBgWakelockRate au cours des 28 derniers jours. Les valeurs quotidiennes sont pondérées par le nombre d'utilisateurs distincts pour la journée.
  • distinctUsers (google.type.Decimal) : nombre d'utilisateurs distincts au cours de la période d'agrégation qui ont été utilisés comme valeur de normalisation pour la métrique stuckBgWakelockRate. Un utilisateur est comptabilisé dans cette métrique si son application effectuait une tâche sur l'appareil, c'est-à-dire non seulement une utilisation active au premier plan, mais également une tâche en arrière-plan. Veillez à ne pas agréger davantage ce nombre, car les utilisateurs pourraient être comptabilisés plusieurs fois. La valeur est arrondie au multiple le plus proche de 10, 100, 1 000 ou 1 000 000, selon l'ordre de grandeur de la valeur.
filter

string

Facultatif. Filtres à appliquer aux données. L'expression de filtrage suit la norme AIP-160 et permet de filtrer par égalité toutes les dimensions de répartition.
pageSize

integer

Facultatif. Taille maximale des données renvoyées.

Si aucune valeur n'est spécifiée, un maximum de 1 000 lignes est affiché. La valeur maximale est 100 000. Les valeurs supérieures sont réduites à 100 000.
pageToken

string

Facultatif. Jeton de page reçu d'un appel précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à la requête doivent correspondre à l'appel ayant fourni le jeton de page.
userCohort

enum (UserCohort)

Facultatif. Vue utilisateur à sélectionner. Les données de sortie correspondent à la vue sélectionnée. La seule valeur acceptée est OS_PUBLIC.

Corps de la réponse

Message de réponse pour stuckbackgroundwakelockrate.query.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
Champs
rows[]

object (MetricsRow)

Lignes de données renvoyées.
nextPageToken

string

Jeton de continuation permettant de récupérer la page de données suivante.

Niveaux d'accès des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/playdeveloperreporting

Pour plus d'informations, consultez la OAuth 2.0 Overview.