KappS Base de connaissances · Blog

Google Play API Developer Reporting en 2026

Blog Tutoriel

Google Play affiche déjà les chiffres de plantage et d'ANR dans la console. Cette vue est conçue pour une application, une personne, un après-midi. L'API Play Developer Reporting existe pour l'autre usage : extraire les mêmes données de qualité selon un calendrier, pour toutes les applications que vous exploitez, vers votre propre entrepôt de données ou votre pipeline d'alertes. Ce n'est pas une seconde console. C'est une manière normalisée de poser les mêmes questions sur quarante applications sans ouvrir quarante onglets.

Ce tutoriel présente la séquence qui fonctionne réellement en 2026, dans l’ordre où les erreurs apparaissent si vous vous y prenez mal : projet, compte de service, autorisation dans la Play Console, découverte de l’application, fraîcheur, requête, dimensions, anomalies. Chaque étape est un appel documenté, et les deux points où la plupart des équipes échouent sont l’invitation dans la Play Console à l’étape 3 et l’hypothèse de fuseau horaire à l’étape 7.

1. Sachez ce que renvoie l’API avant d’écrire du code

Le service expose des ensembles de métriques : des groupes logiques de métriques liées qui partagent une granularité et peuvent être interrogées ensemble. Les ensembles documentés couvrent le taux d’ANR, le taux de plantage, le taux de réveil excessif, le taux de wakelock d’arrière-plan bloqué, le taux de démarrage lent, le taux de rendu lent, le taux de LMK (arrêt pour mémoire insuffisante), l’utilisation de la mémoire RSS anonyme et de swap, l’utilisation de la mémoire bitmap et le nombre d’erreurs. Chaque ensemble comporte des métriques normalisées telles que crashRate, userPerceivedCrashRate, ainsi que les moyennes pondérées par utilisateur sur 7 et 28 jours.

Deux faits pratiques découlent de cette conception. Premièrement, ce sont des agrégats — des pourcentages d’utilisateurs distincts, des centiles pour la mémoire — l’API peut donc être exécutée depuis un serveur sans manipuler de données au niveau utilisateur. Deuxièmement, certaines ressources sont plus restreintes que ne le suggère le numéro de version : l’ensemble des comptages d’erreurs n’est disponible que dans la version v1alpha1 de l’API, tandis que v1beta1 et v1alpha1 exposent sinon les mêmes ressources avec les mêmes formes de méthodes. Choisissez votre version par ressource, pas par projet.

2. Créer le projet Cloud et activer l'API

Il vous faut toujours un projet Cloud Google avec l’API activée, mais une évolution de 2026 supprime une étape que beaucoup anticipent encore : vous n’avez plus besoin de lier votre compte développeur Play à la Cloud Console pour utiliser l’API Reporting. Les quatre étapes documentées sont les suivantes : créer (ou réutiliser) un projet Cloud, y activer l’Google Play Developer Reporting API, créer un compte de service, puis accorder à ce compte de service l’accès dans la Play Console.

Activer l’API se fait en un clic sur la page de l’API dans la Cloud Console. Faites-le dans le projet qui contient déjà votre facturation et votre IAM, pas dans un projet jetable — les clés de compte de service survivent à la personne qui les a créées, et les projets orphelins sont la façon dont la supervision meurt discrètement un an plus tard.

3. Accordez au compte de service exactement un scope, puis un rôle Play Console

Les comptes de service sont le choix documenté pour les tâches non supervisées, et ils s'authentifient avec une clé JSON qui ne doit jamais quitter le serveur. Chaque appel de cette API s'autorise sur un seul scope OAuth :

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

Viennent ensuite les autorisations qui conditionnent réellement votre premier 403. Activer l'API ne signifie pas être autorisé à lire les données. Rendez-vous dans Utilisateurs et autorisations dans la Play Console, invitez l'adresse du compte de service lui-même (your-name@your-project.iam.gserviceaccount.com) et accordez les droits minimaux nécessaires aux ensembles de métriques que vous interrogez — les recommandations de Google sont d'accorder l'ensemble minimal d'autorisations par action API, et différents ensembles de métriques nécessitent différentes autorisations. Une tâche de reporting n'a jamais besoin d'un accès administrateur, de gestion des versions ou financier.

Stockez le fichier de clé hors du dépôt et gardez un compte de service par portefeuille plutôt qu’un par application. Faire tourner une seule clé d’identification prend cinq minutes ; en faire tourner trente, c’est un week-end.

4. Découvrir les ID d'application visibles par le compte

Before any metric call, resolve which apps the credential can reach. The service endpoint is https://playdeveloperreporting.googleapis.com, and the app list comes from:

GET /v1beta1/apps:search

Lancez cette vérification une fois par portefeuille et mettez le résultat en cache. C’est le moyen le moins coûteux de prouver que l’invitation de l’étape 3 a fonctionné : une liste vide avec un jeton valide signifie presque toujours que le compte de service a été invité sur le mauvais compte, ou invité sans qu’une autorisation incluant la visibilité des applications ne lui soit accordée.

5. Vérifier la fraîcheur avant de faire confiance à un chiffre

Chaque jeu de métriques répond à un simple GET qui renvoie l’horodatage du dernier point de données disponible — sa fraîcheur — avec une valeur par granularité prise en charge (quotidienne et horaire). Lancez chaque exécution planifiée à partir de là au lieu de supposer que la veille existe. Utilisez directement la valeur de fraîcheur renvoyée comme borne de votre plage de requête, et la tâche s’aligne d’elle-même : plus de décalage codé en dur, plus de réponse vide au lendemain d’une release discrète.

Une donnée manquante n’est pas un zéro. Si votre entrepôt de données écrit 0,0 % parce que la plage n’a renvoyé aucune ligne, votre tableau de bord affichera une application parfaite jusqu’au jour où quelqu’un vérifiera la console.

6. Interroger un ensemble avec la méthode POST :query

Les données proviennent d’une méthode :query personnalisée sur la ressource metric-set, pas d’un appel de liste. Chaque requête précise une granularité, une plage temporelle, les métriques et les dimensions de ventilation :

POST https://playdeveloperreporting.googleapis.com/v1beta1/apps/<package>/crashRateMetricSet:query // body { "timelineSpec": { "aggregationPeriod": "DAILY", "startTime": { "year": 2026, "month": 10, "day": 14 }, "endTime": { "year": 2026, "month": 10, "day": 20 } }, "dimensions": ["versionCode", "countryCode"], "metrics": ["crashRate", "userPerceivedCrashRate", "distinctUsers"], "pageSize": 1000 }

La réponse est une liste de lignes indexées par les dimensions demandées, plus un pageToken lorsqu’il reste des données à lire. filter restreint les lignes par égalité de dimension ; la pagination a la même forme pour tous les ensembles de métriques, si bien qu’un paginateur générique couvre aussi bien le taux de plantage que le taux d’ANR ou la mémoire.

7. Choisir les dimensions à dessein — et surveiller les deux pièges de calendrier

C’est sur les dimensions que l’API prend l’avantage sur la console. versionCode transforme un taux de plantage à l’échelle de la flotte en contrôle de régression par version. countryCode isole un marché où un nouveau SDK se comporte mal. Les dimensions d’appareil — deviceModel, deviceType, apiLevel, deviceRamBucket, ainsi que les champs SoC, CPU, GPU et écran — séparent « notre code a cassé » de « ce chipset a cassé ».

Deux pièges d’horloge frappent chaque équipe une fois. L’agrégation quotidienne est documentée comme utilisant un fuseau horaire fixe America/Los_Angeles, tandis que l’agrégation horaire est fixée à UTC. Si votre journée de travail est en CST, un compartiment quotidien ne commence pas quand vous le pensez, et une version déployée à 09:00 heure locale se répartit sur deux compartiments. Second piège : une journée vide n’est souvent qu’un décalage de fraîcheur des données, d’où l’importance de commencer par l’étape 5.

La documentation mentionne aussi une limite de performance stricte à prendre en compte dès la conception : la taille de la plage demandée doit être inversement proportionnelle à la taille de l’application et au nombre de ventilations. Une application volumineuse interrogée sur trente jours et six dimensions expirera. Bouclez sur des fenêtres courtes pour les grosses applications plutôt que de lancer une requête héroïque.

8. Laisser Google détecter les anomalies

Pas besoin de construire des calculs de seuils par-dessus ces métriques pour obtenir des alertes. L’API expose une collection d’anomalies qui liste les anomalies Google déjà détectées dans l’un des jeux de données, filtrées selon leur période d’activité :

GET /v1beta1/apps/<package>/anomalies ?filter=activeBetween("2026-10-19T00:00:00Z","2026-10-21T00:00:00Z") &pageSize=50

Les deux bornes sont des chaînes RFC-3339 avec décalages UTC autorisés, et chaque borne accepte la valeur spéciale UNBOUNDED pour les fenêtres à sens unique. pageSize vaut 10 par défaut et est plafonné à 100. Chaque anomalie porte son type, sa gravité, les dimensions concernées et les métriques impliquées, de sorte qu’une interrogation planifiée se transforme proprement en un message exploitable par un humain.

Pour les traces de pile plutôt que les taux, la même API expose les problèmes d’erreur et les rapports d’erreur — les couches regroupée et individuelle — dans les deux versions. C’est la différence entre « le taux de plantage a doublé sur la v1.4.2 » et « voici la frame qui a bougé ».

9. Le relier au cycle de vie du compte, pas seulement au calendrier

L’autorisation accordée à l’étape 3 est attachée au compte développeur, ce qui signifie qu’elle suit le compte. Lorsqu’un compte Play change de mains — un transfert, une vente de portefeuille, une reconstruction après une suspension — le Play Console du nouveau propriétaire doit réinviter votre compte de service, sinon chaque appel renvoie 403 tandis que votre tableau de bord conserve ses dernières valeurs connues. C’est le mode de défaillance sur lequel il faut alerter explicitement : alertez sur les 403 et sur une liste d’applications vide, pas seulement sur les 5xx, car l’API répond volontiers « aucune donnée » à un identifiant qui a été discrètement débranché.

Gardez le monitoring ennuyeux : un compte de service par portefeuille, une exécution planifiée qui lit la fraîcheur puis interroge les ensembles qui vous intéressent, une détection d’anomalies en second passage, et un seul message par jour, silencieux quand rien n’a bougé. Tout le reste — seuils, références de tendance, tableaux par pays — est de l’analyse que vous pouvez ajouter sans retoucher la plomberie.

Vous gérez des comptes développeur à grande échelle ? Nous prenons en charge le volet opérationnel.

Cliquez pour choisir un fichier · clic droit → Coller, ou appuyez sur Ctrl/⌘+V pour coller une capture d’écran

Vous pouvez aussi glisser un fichier sur cette zone.

Nous répondons à l’e-mail que vous indiquez. Vos données restent chez KappS.

✔ Soumis

Nous avons bien reçu votre message et vous répondrons sous 24 heures.


← Retour à la modification