Method: vitals.crashrate.query

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

Requête HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/crashRateMetricSet}: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}/crashRateMetricSet

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 fuseau horaire par défaut (le seul compatible) est America/Los_Angeles.
  • HOURLY: les métriques sont agrégées par intervalles horaires. Le seul fuseau horaire par défaut accepté est UTC.
dimensions[]

string

Dimensions par lesquelles les métriques 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:

  • crashRate (google.type.Decimal): pourcentage d'utilisateurs distincts ayant subi au moins un plantage pendant la période d'agrégation.
  • crashRate7dUserWeighted (google.type.Decimal): valeur moyenne glissante de crashRate au cours des sept derniers jours. Les valeurs quotidiennes sont pondérées par le nombre d'utilisateurs distincts pour la journée.
  • crashRate28dUserWeighted (google.type.Decimal): valeur moyenne glissante de crashRate au cours des 28 derniers jours. Les valeurs quotidiennes sont pondérées par le nombre d'utilisateurs distincts pour la journée. Non compatible avec le niveau de précision HOURLY.
  • userPerceivedCrashRate (google.type.Decimal): pourcentage d'utilisateurs distincts pendant la période d'agrégation qui ont subi au moins un plantage pendant qu'ils utilisaient activement votre application (plantage repéré par l'utilisateur). Une application est considérée comme active si elle affiche une activité ou exécute un service de premier plan.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): valeur moyenne glissante de userPerceivedCrashRate au cours des sept derniers jours. Les valeurs quotidiennes sont pondérées par le nombre d'utilisateurs distincts pour la journée. Non compatible avec le niveau de précision HOURLY.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): valeur moyenne glissante de userPerceivedCrashRate au cours des 28 derniers jours. Les valeurs quotidiennes sont pondérées par le nombre d'utilisateurs distincts pour la journée. Non compatible avec le niveau de précision HOURLY.
  • 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 les métriques crashRate et userPerceivedCrashRate. Un utilisateur est comptabilisé dans cette métrique s'il a utilisé l'application activement pendant la période d'agrégation. Une application est considérée comme active si elle affiche une activité ou exécute un service de premier 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 crashrate.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.