Présentation
La Google Play Console fournit une suite d'API de services Web basées sur REST qui vous permet d'exécuter des fonctions de publication, de création de rapports et d'autres fonctions de gestion directement pour votre application.
Tous les développeurs n'ont pas besoin d'utiliser ces API. Dans la plupart des cas, vous pouvez continuer à gérer vos applications directement via la Google Play Console. Toutefois, si vous avez un grand nombre de fichiers APK à gérer ou si vous devez suivre les achats et les abonnements des utilisateurs, ces API peuvent vous être utiles.
API comprises
Les API Google Play Developer vous permettent de vous concentrer sur la conception et le développement de votre application, tout en passant moins de temps à gérer vos versions, même si vous vous développez sur de nouveaux marchés.
La Google Play Console comprend une suite d'API que vous pouvez utiliser pour gérer votre application :
- L'API Publishing vous permet d'importer et de publier des applications, et d'effectuer d'autres tâches liées à la publication.
- L'API Subscriptions and In-App Purchases vous permet de gérer les achats via une application et les abonnements. (Celle-ci était auparavant appelée "API Purchase Status".)
- L'API Reporting vous permet de récupérer des informations sur la qualité de votre application à partir d'Android Vitals.
- L'API Reply to Reviews vous permet de récupérer les avis sur votre application et d'y répondre.
- L'API Permissions vous permet d'automatiser la gestion des autorisations dans la Play Console.
- L'API Play Games Services Management vous permet d'émettre des appels REST pour contrôler de manière automatisée les métadonnées sous-jacentes aux fonctionnalités des services de jeux Google Play.
- L'API Voided Purchases fournit la liste des commandes associées aux achats qu'un utilisateur a annulés.
Premiers pas
Pour commencer à utiliser les API Google Play Developer, consultez la documentation de démarrage.
API Publishing
L'API Publishing vous permet d'automatiser les tâches fréquentes liées à la distribution d'applications. Elle fournit des fonctions semblables à celles disponibles pour un développeur via la Play Console, par exemple :
- Importation de nouvelles versions d'une application
- Publication des applications en attribuant des APK à différents canaux (alpha, bêta, déploiement par étapes ou production)
- Création et modification de fiches Google Play Store, y compris avec du texte et des images localisés, ainsi que des captures d'écran multi-appareils
Ces tâches sont effectuées à l'aide de la fonctionnalité de modification, qui adopte une approche transactionnelle pour effectuer les modifications. Cela vous permet de regrouper plusieurs modifications dans un seul brouillon, puis de valider toutes les modifications en même temps. (Aucune des modifications ne prend effet tant que le brouillon n'a pas été validé.)
Bonnes pratiques
- Limitez le nombre de mises à jour de l'application. Ne publiez pas de mises à jour alpha ou bêta plus d'une fois par jour (les applications de production doivent être mises à jour encore moins fréquemment). Chaque mise à jour coûte du temps et peut-être de l'argent à vos utilisateurs. Si vous effectuez des mises à jour trop fréquentes, les utilisateurs peuvent commencer à les ignorer, voire désinstaller le produit.
API Subscriptions and In-App Purchases
L'API Subscriptions and In-App Purchases vous permet de gérer le catalogue des abonnements et des produits intégrés à votre application. En outre, avec l'API Subscriptions and In-App Purchases, vous pouvez rapidement récupérer les détails de tout achat à l'aide d'une requête GET standard.
Dans la requête, vous fournissez des informations sur l'achat (nom du package de l'application, ID de l'achat ou de l'abonnement et jeton d'achat). Le serveur répond avec un objet JSON décrivant les détails de l'achat associés, l'état de la commande, la charge utile du développeur et d'autres informations.
Vous pouvez utiliser cette API de différentes manières, par exemple pour créer des rapports et rapprocher des commandes individuelles, ou pour vérifier les achats et les expirations d'abonnement. Vous pouvez également utiliser l'API pour en savoir plus sur les commandes annulées et vérifier si les produits intégrés à l'application ont été utilisés, y compris s'ils ont été utilisés avant d'être annulés.
Bonnes pratiques
- Stockez les informations d'abonnement sur votre serveur pour éviter d'effectuer des appels d'API inutiles. Lorsque votre application doit vérifier un abonnement, vous devez vous appuyer sur les informations mises en cache sur votre serveur plutôt que de répéter l'appel d'API à Google.
- Il existe deux cas dans lesquels votre serveur sécurisé doit utiliser l'API Google Play Developer pour obtenir des informations sur les abonnements :
- Votre serveur reçoit un jeton d'achat inédit.
- Votre serveur reçoit une notification en temps réel pour les développeurs (RTDN), qui indique que vous devez utiliser le jeton d'achat pour obtenir les informations sur le nouvel abonnement.
- Évitez d'interroger régulièrement l'API pour connaître l'état de vos abonnements. Par exemple, n'appelez pas l'API tous les jours pour vérifier chaque abonnement.
- Étant donné que vous recevez une notification RTDN lorsque l'abonnement expire ou est renouvelé, vous n'avez pas besoin de planifier un appel d'API en fonction du délai d'expiration planifié.
API Reporting
L'API Reporting s'adresse aux développeurs qui souhaitent créer des workflows automatisés en plus des données de la Play Console, ou aux développeurs qui utilisent les données de la Play Console pour la création de rapports et d'analyses internes à l'entreprise, potentiellement avec d'autres ensembles de données. Vous bénéficiez ainsi d'un accès programmatique aux données et métriques au niveau de l'application à des fins d'automatisation, d'analyse et de création de rapports en interne.
L'API Reporting permet d'accéder aux données Android Vitals, y compris au taux de plantages, au taux d'erreurs ANR, aux problèmes de wakeup et de wakelock, ainsi qu'aux traces de la pile d'erreurs.
Bonnes pratiques
- Cette version de l'API Reporting présente une limite par défaut de 10 requêtes par seconde. Vous pouvez consulter votre utilisation des quotas dans la section Quotas de la console Google Cloud. Si vous devez dépasser cette limite, vous pouvez envoyer une demande de quota à l'aide de ce formulaire.
API Reply to Reviews
L'API Reply to Reviews vous permet d'afficher les commentaires des utilisateurs concernant votre application et d'y répondre. Vous pouvez utiliser cette API pour interagir avec les utilisateurs directement depuis votre kit d'outils pour le service client, par exemple un système de CRM.
L'API Reply to Reviews ne vous permet d'accéder qu'aux commentaires relatifs aux versions de production de votre application. Si vous souhaitez obtenir des commentaires sur les versions alpha ou bêta de votre application, utilisez la Google Play Console. Notez également que l'API n'affiche que les avis qui incluent des commentaires. Si un utilisateur évalue votre application, mais ne laisse aucun commentaire, son avis n'est pas accessible depuis l'API.
API Permissions
L'API Permissions permet aux développeurs d'automatiser la gestion des autorisations dans la Play Console. Vous pouvez ainsi contrôler de manière flexible qui a accès à votre compte de développeur sans intervention manuelle.
Avec l'API Permissions, vous pouvez effectuer des tâches d'administration telles que :
- Supprimer l'accès des utilisateurs lorsqu'ils quittent votre entreprise
- Accorder l'accès à une application lorsqu'un utilisateur rejoint l'équipe concernée
API Voided Purchases
L'API Voided Purchases fournit la liste des commandes associées aux achats qu'un utilisateur a annulés. Vous pouvez utiliser les informations de cette liste pour implémenter un système de révocation qui empêche l'utilisateur d'accéder aux produits de ces commandes.
Cette API s'applique aux commandes et abonnements ponctuels effectués via une application.
Un achat peut être annulé pour les raisons suivantes :
- L'utilisateur demande le remboursement de sa commande.
- L'utilisateur annule sa commande.
- Une commande est rejetée.
- Le développeur annule ou rembourse la commande. Remarque : Seules les commandes annulées seront affichées dans l'API Voided Purchases. Si le développeur rembourse sans définir l'option de révocation, les commandes ne s'affichent pas dans l'API.
- Google annule ou rembourse la commande.
En utilisant cette API, vous contribuez à créer une expérience plus équilibrée et équitable pour tous les utilisateurs de votre application, en particulier s'il s'agit d'un jeu.