Avant de pouvoir commencer à appeler des API, vous devez configurer l'accès aux API dans votre compte de développeur Google Play. Cela implique de modifier la console Google Play et la console Google Cloud. Les instructions suivantes expliquent les quatre étapes nécessaires pour commencer à utiliser l'API Google Play Developer.
- Associez votre compte de développeur à un projet Google Cloud nouveau ou existant.
- Activez l'API Google Play Developer pour votre projet Google Cloud associé.
- Autorisez une clé API pour l'API Google Play Developer dans votre projet Google Cloud associé.
- Configurez un compte de service avec les autorisations Google Play Console appropriées pour accéder à l'API Google Play Developer.
Associer votre compte à votre projet
Avant de pouvoir accéder à l'API Google Play Developer, vous devez associer votre compte de développeur Google Play à un projet Google Cloud. Dans la plupart des cas, nous vous recommandons de créer un projet Google Cloud dédié à votre compte de développeur Google Play, mais vous pouvez associer un projet existant. N'oubliez pas que chaque compte de développeur Google Play ne peut être associé qu'à un seul projet Google Cloud. Si vous disposez de plusieurs applications dans le même compte de développeur Google Play, elles doivent toutes partager le même projet Google Cloud.
Créer un projet
- Accédez à la page Accès à l'API dans la Google Play Console.
- Cliquez sur Create new project (Créer un projet).
Le projet Google Cloud est automatiquement créé et associé à votre compte de développeur Google Play.
Utiliser un projet existant
Si vous utilisez déjà Google Cloud Console, vous pouvez associer votre projet Google Cloud existant en procédant comme suit:
- Accédez à la page Accès à l'API dans la Google Play Console.
- Sélectionnez le projet que vous souhaitez associer. Si votre projet ne figure pas dans la liste, vérifiez que votre compte utilisateur est désigné comme propriétaire dans le projet Google Cloud que vous souhaitez associer.
- Cliquez sur Associer un projet existant.
Activer l'API
Une fois le projet Google Cloud associé configuré, vous devez activer l'API Google Play Developer pour ce projet. Pour ce faire, vous devez être propriétaire du projet Google Cloud.
- Accédez à la page Accès à l'API dans la Google Play Console.
- Sous API, recherchez l'API Google Play Developer, puis cliquez sur Activer.
Le projet Google Cloud est alors directement mis à jour, et la modification prend effet immédiatement.
Autoriser une clé API
Pour utiliser l'API, vous devez disposer d'une clé API dans votre projet Google Cloud associé qui soit autorisée à utiliser l'API Google Play Developer. Effectuez cette configuration dans la Google Play Console.
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 d'être divulgués aux 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 à partir du 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 pour le compte d'un utilisateur sans compromettre les identifiants du compte de service.
- Compte de service: un service logiciel sécurisé accède à l'API (méthode la plus courante)
- Clients OAuth: un utilisateur accèdera à l'API.
Utiliser un compte de service
Vous pouvez créer un compte de service à partir de la Google Play Console.
- Accédez à la page Accès à l'API dans la Google Play Console.
- Sous Comptes de service, cliquez sur Créer des comptes de service.
Suivez les instructions pour créer votre compte de service.
Au cours du processus de création du compte, vous devez autoriser votre compte de service à accéder au projet Google Cloud pour qu'il apparaisse dans la Google Play Console.
Une fois le compte de service créé dans la Google Play Console, cliquez sur OK. La section "Comptes de service" de la page Accès à l'API s'actualise automatiquement et votre compte de service est répertorié.
Cliquez sur Accorder l'accès pour accorder au compte de service 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
À 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 l'authentification 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.
- Accédez à la page Accès à l'API dans la Google Play Console.
- Sous Clients OAuth, cliquez sur Configurer l'écran d'autorisation OAuth.
- Configurez les informations de branding de votre produit.
- Lorsque vous avez terminé, cliquez sur Actualiser le consentement OAuth. La section est alors mise à jour, et le message concernant les informations de branding ne s'affiche plus.
Pour créer un client OAuth à l'aide de la Google Play Console:
- Accédez à la page Accès à l'API dans la Google Play Console.
- Sous Clients OAuth, cliquez sur Créer un client OAuth.
- Suivez les instructions de la page pour créer votre client OAuth.
Une fois le client OAuth créé sur la Google Play Console, cliquez sur OK. La section Clients OAuth de la page Accès à l'API s'actualise automatiquement et votre client OAuth est répertorié.
Parfois, le nouveau client OAuth n'apparaît pas immédiatement sur la page. Dans ce cas, cliquez sur Actualiser les clients OAuth.
Les détails de votre nouveau client OAuth s'affichent sous forme de liste sur cette page.
Informations complémentaires
Suivez les conseils et astuces ci-dessous pour commencer à utiliser l'API sur Google Play.
Obtenir votre ID de développeur
Vous devez fournir un ID de développeur Google Play Console pour certaines API. Il s'agit d'un long numéro attribué lors de la création de votre compte de développeur Google Play. Votre ID de développeur se trouve dans l'URL de presque toutes les pages de la Google Play Console (par exemple, la page Accès API).
Prenons l'exemple de l'URL 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 de 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:
- Répondre à l'API Reviews
- Permet de consulter les commentaires des utilisateurs concernant votre application et d'y répondre.
- API Voided Purchases
- Permet de révoquer l'accès aux produits intégrés à l'application associés aux achats qu'un utilisateur a annulés.
Bibliothèques clientes
Nous avons fourni des bibliothèques clientes pour accéder aux API REST de manière automatisée. Pour en savoir plus, consultez Bibliothèques clientes et exemples de code.