Method: vitals.crashrate.query
Interroge les métriques de l'ensemble de métriques.
Requête HTTP
POST https://playdeveloperreporting.googleapis.com/v1beta1/{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érencedeviceSocModel (string): modèle de la puce principale du système de l'appareil, par exemple "Exynos 2100". RéférencedeviceCpuMake (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:
|
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2023/11/29 (UTC).
[null,null,["Dernière mise à jour le 2023/11/29 (UTC)."],[[["Queries the Crash Rate metric set to analyze app stability across dimensions like API level, device model, and country."],["Allows filtering data by specific dimensions and supports daily or hourly aggregation periods with corresponding timezones."],["Returns crash rate metrics, including overall crash rate, user-perceived crash rate, and distinct user counts."],["Offers optional pagination for large datasets and requires the `https://www.googleapis.com/auth/playdeveloperreporting` authorization scope."]]],[]]
