Avant de pouvoir commencer à effectuer des appels d'API, vous devez configurer l'accès à l'API sur votre compte de développeur Google Play. Cela implique des modifications dans la Google Play Console et la console Google Cloud. Les instructions suivantes décrivent la procédure à suivre pour commencer à utiliser l'API Google Play Developer.
- Créer un projet Google Cloud
- Activez l'API Google Play Developer pour votre projet Google Cloud.
- Configurez un compte de service avec les autorisations Google Play Console appropriées 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 la page 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 de l'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 pour ne pas être divulgués aux personnes non autorisées à utiliser l'API.
Utilisez l'ID client OAuth si vous devez accéder à l'API au nom d'un utilisateur individuel. Par exemple, si votre site Web doit accéder à l'API Google Play Developer depuis le client Web au nom 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 à partir de la Google Play Console.
- Dans la console Google Cloud, accédez à Comptes de service.
- Cliquez sur Créer un compte de service et 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 d'adresse e-mail et 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 la page 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 via 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 la procédure permettant de créer l'é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
Suivez les conseils et astuces ci-dessous pour commencer à utiliser les API sur Google Play.
Obtenir votre ID de développeur
Certaines API nécessitent un ID de développeur Google Play Console. Long numéro 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 est 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'analyse spécifiques sur votre application:
- API Reply to Reviews
- Vous permet de consulter 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 à des achats qu'un utilisateur a annulés.
Bibliothèques clientes
Nous avons fourni des bibliothèques clientes que vous pouvez utiliser pour accéder aux API REST de manière automatisée. Pour en savoir plus, consultez la page Bibliothèques clientes et exemples de code.