Method: vitals.stuckbackgroundwakelockrate.query

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

Requête HTTP

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

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 dans des intervalles de dates calendaires. En raison de contraintes historiques, le seul fuseau horaire accepté est America/Los_Angeles.
dimensions[]

string

Dimensions par lesquelles les données sont segmenté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 de l'appareil de l'utilisateur. L'identifiant se présente sous la forme "deviceBrand/device", "deviceBrand" correspond à Build.BRAND et "device" correspond à 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 TÉLÉPHONE.
  • countryCode (string): pays ou région où se trouve l'appareil de l'utilisateur, en fonction de son adresse IP, sous la forme d'un code ISO-3166 à deux lettres (par exemple, "US" pour les États-Unis).
  • deviceRamBucket (int64): RAM de l'appareil, en Mo et en buckets (3 Go, 4 Go, etc.).
  • deviceSocMake (string): type de la puce principale du système de l'appareil, par exemple Samsung. Référence
  • deviceSocModel (string): modèle de la puce principale du système de l'appareil, par exemple "Exynos 2100". Référence
  • deviceCpuMake (string): type de processeur de l'appareil, par exemple Qualcomm.
  • deviceCpuModel (string): modèle du processeur de l'appareil, par exemple "Kryo 240".
  • deviceGpuMake (string): marque du GPU de l'appareil, par exemple ARM.
  • deviceGpuModel (string): modèle du GPU de l'appareil, par exemple Mali.
  • deviceGpuVersion (string): version du GPU 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 NORMALE, GRANDE.
  • deviceScreenDpi (string): densité d'écran de l'appareil, par exemple mdpi ou hdpi.
metrics[]

string

Métriques à agréger.

Métriques acceptées:

  • stuckBgWakelockRate (google.type.Decimal): pourcentage d'utilisateurs distincts pendant la période d'agrégation pour lesquels un wakelock est conservé 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 pendant la période d'agrégation qui ont été utilisés comme valeur de normalisation pour la métrique stuckBgWakelockRate. Dans cette métrique, un utilisateur est comptabilisé s'il effectue une tâche sur l'appareil, c'est-à-dire non seulement une utilisation active au premier plan, mais aussi en arrière-plan. Veillez à ne pas cumuler ce nombre plus précisément, 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, en fonction de l'amplitude de la valeur.
filter

string

Filtres à appliquer aux données. L'expression de filtrage est conforme à la norme AIP-160 et accepte le filtrage par égalité de toutes les dimensions de répartition.

pageSize

integer

Taille maximale des données renvoyées.

Si aucune valeur n'est spécifiée, 1 000 lignes au maximum seront renvoyées. La valeur maximale est 100 000. Les valeurs supérieures à 100 000 sont forcées à 100 000.

pageToken

string

Jeton de page, reçu lors 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 qui a fourni le jeton de page.

userCohort

enum (UserCohort)

Vue utilisateur à sélectionner. Les données de sortie correspondront à la vue sélectionnée.

Valeurs acceptées:

  • OS_PUBLIC : permet de sélectionner les données de toutes les versions publiques d'Android. Il s'agit de la valeur par défaut. Accepte toutes les dimensions ci-dessus.
  • APP_TESTERS Sélectionner les données provenant d'utilisateurs qui ont accepté de participer aux tests. Accepte toutes les dimensions ci-dessus.
  • OS_BETA : permet de sélectionner uniquement les données des versions bêta d'Android, à l'exclusion des données des versions Android publiées. Seules les dimensions suivantes sont acceptées:
  • versionCode (int64): version de l'application exécutée sur l'appareil de l'utilisateur.

  • osBuild (string): build de l'OS de l'appareil de l'utilisateur, par exemple "T1B2.220916.004".

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 continuité pour récupérer la page de données suivante.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la présentation d'OAuth 2.0.