Method: vitals.crashrate.query

Interroge les métriques du groupe 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 par intervalles de dates civiles. En raison de contraintes historiques, le fuseau horaire par défaut et le seul accepté est America/Los_Angeles.
  • Les métriques HOURLY sont agrégées par intervalles d'une heure. Le fuseau horaire par défaut et le seul accepté est UTC.
dimensions[]

string

Dimensions selon lesquelles segmenter les métriques.

Dimensions acceptées :

  • apiLevel (string) : niveau d'API d'Android exécuté sur l'appareil de l'utilisateur, par exemple 26.
  • versionCode (int64) : version de l'application qui s'exécutait sur l'appareil de l'utilisateur.
  • deviceModel (string) : identifiant unique du modèle d'appareil de l'utilisateur. L'identifiant est au format "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, dans des buckets (3 Go, 4 Go, etc.).
  • deviceSocMake (string) : marque du principal système sur puce 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 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 NORMAL, LARGE.
  • 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 au cours de la période d'agrégation ayant subi au moins un plantage.
  • 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 la précision "HOURLY".
  • userPerceivedCrashRate (google.type.Decimal) : pourcentage d'utilisateurs uniques au cours de la période d'agrégation ayant subi au moins un plantage lorsqu'ils se servaient activement de 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 la 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 la précision "HOURLY".
  • distinctUsers (google.type.Decimal) : nombre d'utilisateurs distincts au cours de la période d'agrégation, utilisé 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 de manière active au cours de 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 agréger davantage ce nombre, car cela pourrait entraîner le comptage des utilisateurs plusieurs fois. La valeur est arrondie au multiple le plus proche de 10, 100, 1 000 ou 1 000 000, selon son ordre de grandeur.
filter

string

Filtres à appliquer aux données. L'expression de filtrage suit la norme AIP-160 et permet de filtrer 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, 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

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)

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

Valeurs acceptées :

  • OS_PUBLIC Pour sélectionner les données de toutes les versions d'Android publiées publiquement. Il s'agit de la valeur par défaut. Compatible avec toutes les dimensions ci-dessus.
  • APP_TESTERS Pour sélectionner les données des utilisateurs qui ont accepté de devenir des testeurs. Compatible avec toutes les dimensions ci-dessus.
  • OS_BETA Pour sélectionner uniquement les données des versions bêta d'Android, à l'exclusion des données des versions publiées d'Android. Seules les dimensions suivantes sont acceptées :

  • versionCode (int64) : version de l'application qui s'exécutait sur l'appareil de l'utilisateur.

  • osBuild (string) : version 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 continuation permettant d'extraire 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 OAuth 2.0 Overview.