Avant de pouvoir effectuer des appels d'API, vous devez configurer l'accès à l'API pour votre compte de développeur Google Play. Cela implique des modifications dans la console Google Play et la console Google Cloud. Les instructions suivantes expliquent comment commencer à utiliser l'API Google Play Developer.
- Créez un projet Google Cloud.
- Activez l'API Google Play Developer pour votre projet Google Cloud.
- Configurez un compte de service avec les autorisations appropriées dans la Google Play Console pour accéder à l'API Google Play Developer.
Créer un projet Google Cloud
Vous pouvez ignorer cette étape si vous disposez déjà d'un projet Google Cloud que vous souhaitez utiliser.
Créez un projet dans la console Google Cloud.
Pour en savoir plus sur les projets Google Cloud, consultez Créer et gérer des projets.
Activer l'API
Une fois le projet Google Cloud configuré, vous devez activer l'API Google Play Developer pour ce projet.
Pour activer l'API Google Play Developer :
- Accédez à la page API Google Play Developer dans la console Google Cloud.
- Cliquez sur Activer.
Configurer OAuth et les comptes de service
Vous devez configurer l'accès à l'API Google Play Developer avec un client OAuth ou un compte de service. Dans la plupart des cas, vous devez utiliser un compte de service pour accéder à l'API.
Les comptes de service doivent être utilisés dans un environnement sécurisé, tel que votre serveur. Les identifiants du compte de service doivent être gérés de manière sécurisée afin de ne pas être révélés à des personnes non autorisées à utiliser l'API.
L'ID client OAuth doit être utilisé si vous devez accéder à l'API pour le compte d'un utilisateur individuel. Par exemple, si votre site Web doit accéder à l'API Google Play Developer depuis le client Web pour le compte de l'utilisateur, vous pouvez utiliser l'ID client. L'utilisateur sera authentifié avec son compte Google au lieu du compte de service. Cela vous permet d'effectuer des appels d'API au nom d'un utilisateur sans compromettre les identifiants du compte de service.
- Compte de service : un service logiciel sécurisé accède à l'API (cas le plus courant)
- Clients OAuth : un utilisateur accède à l'API
Utiliser un compte de service
Vous pouvez créer un compte de service dans la Google Play Console.
- Dans la console Google Cloud, accédez à Comptes de service.
- Cliquez sur Créer un compte de service, puis suivez la procédure.
- Accédez à la page Utilisateurs et autorisations de la Google Play Console.
- Cliquez sur Inviter de nouveaux utilisateurs.
Saisissez l'adresse e-mail de votre compte de service dans le champ "Adresse e-mail", puis accordez les droits nécessaires pour effectuer des actions.
Pour utiliser les API Google Play Billing, vous devez accorder les autorisations suivantes :
- Afficher les données financières, les commandes et les réponses à l'enquête sur les annulations
- Gérer les commandes et les abonnements
Cliquez sur Inviter un utilisateur.
À ce stade, vous devriez pouvoir accéder à l'API Google Play Developer via le compte de service. Pour en savoir plus, consultez Utiliser OAuth 2.0 pour les applications de serveur à serveur.
Utiliser des clients OAuth
Vous pouvez autoriser les utilisateurs à effectuer des actions à l'aide de l'API avec leurs propres identifiants à l'aide d'un client OAuth. Les actions d'un utilisateur sont limitées à celles autorisées sur la page Utilisateurs et autorisations de la Google Play Console.
Avant de créer des clients OAuth, vous devez configurer les informations de branding de votre produit. Pour en savoir plus, consultez Configurer votre écran de consentement OAuth.
- Dans la console Google Cloud, accédez à la page Écran de consentement OAuth.
- Suivez les étapes pour créer un écran de consentement OAuth.
Pour créer un client OAuth :
- Dans la console Google Cloud, accédez à Identifiants.
- Cliquez sur Créer des identifiants > ID client OAuth.
- Choisissez votre type d'application et suivez les instructions.
Informations supplémentaires
Utilisez les conseils et astuces suivants pour vous aider à commencer à utiliser les API sur Google Play.
Obtenir votre ID de développeur
Certaines API vous demandent de fournir un ID de développeur Google Play Console. Il s'agit d'un long numéro qui a été attribué lors de la création de votre compte de développeur Google Play. Vous trouverez votre ID de développeur dans l'URL de presque toutes les pages de la Google Play Console, comme la page Accès à l'API.
Prenons l'exemple de l'URL de la Google Play Console :
https://play.google.com/console/developers/1234567890123456789/api-access
Dans l'URL ci-dessus, l'ID de développeur serait 1234567890123456789.
Remarque : Si une application est transférée d'un compte de développeur Google Play à un autre, l'ID de développeur associé à cette application change. Cela signifie qu'une fois le transfert terminé, vous devez utiliser l'ID de développeur du nouveau compte de développeur Google Play dans les appels d'API pour cette application.
API spécialisées
L'API Google Play Developer contient plusieurs API spécialisées qui vous permettent d'effectuer des types d'analyses spécifiques sur votre application :
- API Reply to Reviews
- Elle vous permet d'afficher les commentaires des utilisateurs concernant votre application et d'y répondre.
- API Voided Purchases
- Vous permet de révoquer l'accès aux produits intégrés associés aux achats qu'un utilisateur a annulés.
Bibliothèques clientes
Nous avons fourni des bibliothèques clientes que vous pouvez utiliser pour accéder de manière programmatique aux API REST. Pour en savoir plus, consultez Bibliothèques clientes et exemples de code.