Configurer les services de jeux Google Play

Cette page explique comment configurer les services de jeux Google Play pour votre jeu Android à l'aide de la Google Play Console. La Play Console vous permet de gérer les services de jeux et de configurer les métadonnées utilisées pour gérer les autorisations et authentifier votre jeu de manière centralisée.

Pour ajouter votre jeu à la Play Console, procédez comme suit :

  • Créez un projet pour votre jeu et fournissez des informations détaillées, dont le nom et la description de ce jeu.

  • Créez et associez les identifiants nécessaires pour autoriser et authentifier votre jeu auprès des services de jeux Google Play.

Avant de commencer

Avant de configurer les services Google Play Jeux, procédez comme suit :

Créer un compte de développeur Google Play

Créer un projet Google Cloud

Vous devez avoir configuré un projet Google Cloud. Pour en savoir plus, consultez

Pour utiliser la Play Console, vous devez activer les API que vous prévoyez d'utiliser avec votre projet.

Console

Activer l'API Google Play Game Services

gcloud 

gcloud services enable \
   --project "PROJECT" \
   "games.googleapis.com"

Se connecter à la console Google Play

Pour vous connecter, accédez à la Google Play Console. Si vous ne vous êtes pas encore inscrit sur la Play Console, un message vous invitant à le faire s'affiche à l'écran.

Ajouter votre jeu à la Play Console

Pour ajouter votre jeu, procédez comme suit :

  1. Dans la Play Console, créez une application et indiquez qu'il s'agit d'un jeu. Pour en savoir plus, consultez Créer et configurer votre application.

  2. Accédez à Grow > Play Games Services > Setup and management > Configuration (Développement > Services de jeux Play > Configuration et gestion > Configuration).

  3. Indiquez si votre jeu utilise déjà des API Google (comme Firebase). Il est important de choisir la bonne option. Dans le cas contraire, votre jeu pourrait rencontrer des problèmes lors de l'utilisation d'API Google. Voici les options qui s'offrent à vous :

    • Non, mon jeu n'utilise pas d'API Google : sélectionnez cette option si vous démarrez la création d'un jeu ou si vous n'avez jamais configuré d'API Google pour ce jeu. Saisissez le nom de votre jeu, puis cliquez sur Create (Créer).

    • Oui, mon jeu utilise déjà des API Google : choisissez cette option si vous avez déjà configuré une API Google pour votre jeu. Le cas échéant, vous verrez la liste de vos projets dans la console Google Cloud. Sélectionnez votre projet dans la liste, puis cliquez sur Use (Utiliser).

    • Utiliser un projet de services de jeux Play existant : si vous souhaitez utiliser un projet de services de jeux Play existant, sélectionnez cette option. La liste des projets associés aux services de jeux Play pour votre compte s'affiche. Sélectionnez votre projet de jeu dans la liste, puis cliquez sur Use (Utiliser). Cette option est moins souvent utilisée, mais elle peut être intéressante si vous démarrez la création d'un jeu dans la Play Console pour modifier le nom du package, ou si vous disposez de versions sans frais et payantes de votre jeu avec des noms de package différents.

    Un projet de jeu associé aux services de jeux Play est alors créé et une entrée correspondante est créée pour vous dans la console Google Cloud.

  4. Dans la section Properties (Propriétés), cliquez sur Edit Properties (Modifier les propriétés) pour ajouter des informations, telles que la description, la catégorie et les assets graphiques de votre jeu. Voici quelques conseils pour définir les propriétés :

Générer un identifiant de client OAuth 2.0

Votre jeu doit disposer d'un identifiant de client OAuth 2.0 pour être authentifié et autorisé à appeler les services de jeux Google Play. Pour configurer les identifiants des services de jeux Play (l'association entre un identifiant de client et votre jeu), créez l'identifiant de client avec Google Cloud Platform. Utilisez ensuite la Google Play Console pour ajouter des identifiants afin d'associer l'identifiant de client à votre jeu.

Pour obtenir des instructions plus détaillées, procédez comme suit :

Si vous n'avez pas encore configuré l'écran de consentement OAuth, la section Identifiants affiche un message vous invitant à le faire.

Invite de configuration de l'écran de consentement OAuth

Cliquez sur Configure (Configurer). Une boîte de dialogue contenant des instructions supplémentaires et un lien profond vers Google Cloud Platform s'affichent.

Invite de configuration de votre écran de consentement OAuth

Assurez-vous que l'écran de consentement est accessible à tous les utilisateurs du jeu. La liste finale des habilitations doit inclure games, games_lite et drive.appdata. Aucune de ces habilitations ne nécessitera la validation de l'application. Nous vous recommandons de publier l'écran de consentement immédiatement. Si c'est impossible, vous pouvez mettre l'écran de consentement à la disposition des testeurs pour leur permettre de se connecter au jeu.

Si vous avez terminé la configuration de l'écran de consentement OAuth, cliquez sur OK. La Google Play Console s'actualise automatiquement. Si la configuration a réussi, vous pouvez créer des identifiants :

Créer des identifiants

Créer un identifiant

Pour autoriser votre jeu à communiquer avec les services de jeux Google Play, vous devez créer des identifiants avec un identifiant de client OAuth2 autorisé.

Dans la section Credentials (Identifiants de connexion), cliquez sur Add credential (Ajouter un identifiant de connexion).

Dans l'assistant, indiquez si vous souhaitez créer des identifiants Android (si l'APK de votre jeu authentifie l'utilisateur et utilise les API des services de jeux Play) ou des identifiants de serveur de jeu (si votre serveur de jeux utilise les services de jeux Play). Suivez les instructions correspondant au type d'identifiants souhaité.

Android

Configurer les identifiants

Assurez-vous que le nom indiqué dans le champ Name (Nom) correspond à celui de votre jeu. Indiquez si vous souhaitez activer l'antipiratage.

Configurer les autorisations

Ensuite, choisissez un identifiant de client OAuth à utiliser pour ce projet de jeu. Si vous disposez déjà d'identifiants de client OAuth2, vous pouvez en choisir un. Mais dans la plupart des cas, il faut en créer un. Cliquez sur Create OAuth client (Créer un client OAuth). Cette action ouvre une boîte de dialogue contenant des liens profonds et des instructions pour créer un identifiant de client OAuth dans Google Cloud Platform.

  1. Sélectionnez Android comme type d'application.
  2. Saisissez le nom de votre jeu dans le champ Name (Nom).
  3. Saisissez le nom de package de votre application Android dans le champ Package name (Nom du package).

  4. Ouvrez un terminal et exécutez l'utilitaire Keytool pour obtenir les empreintes SHA1 des certificats de version et de débogage.

    Pour obtenir l'empreinte du certificat de version, exécutez la commande suivante :

    keytool -list -keystore <path-to-production-keystore> -v

    Pour obtenir l'empreinte du certificat de débogage, exécutez la commande suivante :

    keytool -list -keystore <path-to-debug-keystore> -v Remarque: Sous Windows, le keystore de débogage se trouve dans l'emplacement C:\Users\<USERNAME>\.android\debug.keystore. Sous Mac ou Linux, le keystore de débogage se trouve généralement dans l'emplacement ~/.android/debug.keystore.

  5. Facultatif: Si vous avez créé un keystore à l'aide d'Unity Hub, ne créez pas de certificat en suivant les instructions de l'étape précédente. Utilisez l'empreinte SHA1 que vous avez créée dans Unity.

    • Utilisez la commande suivante pour imprimer l'empreinte SHA1 dans le terminal:

      keytool -list -keystore <var>path</var>/<var>name_of_keystore</var>.keystore -v

  6. L'utilitaire keytool vous invite à saisir un mot de passe pour le keystore. L'utilitaire keytool imprime ensuite l'empreinte numérique sur le terminal.

  7. Collez l'empreinte SHA1 dans le champ Signing certificate fingerprint (SHA1) (Signature d'empreinte du certificat [SHA1]).

  8. Cliquez sur Créer.

Pour en savoir plus sur OAuth 2.0 sur Android, consultez la page S'authentifier auprès des services OAuth2.

Une fois que vous avez cliqué sur OK dans la boîte de dialogue, les identifiants de client disponibles s'actualisent. Choisissez les identifiants que vous avez créés dans le menu déroulant, puis cliquez sur Save Changes (Enregistrer les modifications). Les identifiants sont alors créés en tant que brouillon, ce qui vous permet de vous authentifier auprès des services de jeux Play pour votre jeu.

Vous pouvez créer deux identifiants : l'un avec l'empreinte du certificat de version et l'autre avec l'empreinte du certificat de débogage. Veillez à utiliser le même nom de package pour les deux. Cela permet aux services de jeux Google Play de reconnaître les appels provenant de vos APK associés et signés avec l'un de ces certificats. Pour en savoir plus sur la signature de certificat pour Android, consultez Signer votre application.

Serveur de jeux

Configurer les identifiants

Assurez-vous que le nom indiqué dans le champ Name (Nom) correspond à celui de votre jeu.

Configurer les autorisations

Ensuite, choisissez un identifiant de client OAuth à utiliser pour ce projet de jeu. Si vous disposez déjà d'identifiants de client OAuth2, vous pouvez en choisir un. Mais dans la plupart des cas, il faut en créer un. Cliquez sur Create OAuth client (Créer un client OAuth). Cette action ouvre une boîte de dialogue contenant des liens profonds et des instructions pour créer un identifiant de client OAuth dans Google Cloud Platform.

  1. Sélectionnez Application Web comme type d'application.
  2. Saisissez le nom de votre jeu dans le champ Name (Nom).
  3. Cliquez sur Create (Créer).

Pour en savoir plus sur OAuth 2.0 sur Android, consultez la page S'authentifier auprès des services OAuth2.

Une fois que vous avez cliqué sur OK dans la boîte de dialogue, les identifiants de client disponibles s'actualisent. Choisissez les identifiants que vous avez créés dans le menu déroulant, puis cliquez sur Save Changes (Enregistrer les modifications). Les identifiants sont alors créés en tant que brouillon, ce qui vous permet de vous authentifier auprès des services de jeux Play depuis votre serveur de jeu. Pour en savoir plus sur l'utilisation des services de jeux Play avec votre serveur de jeu, consultez la page Activer l'accès côté serveur aux services de jeux Google Play.

Activer les tests

Pour vous assurer que les services de jeux Google Play fonctionnent correctement dans votre jeu, testez-les avant de publier les modifications apportées à votre jeu sur Google Play.

Si votre jeu n'est pas publié, accordez l'accès à vos testeurs en ajoutant leurs comptes utilisateur à la liste d'autorisation. Sinon, vos testeurs rencontreront des erreurs OAuth et 404 lorsqu'ils tenteront d'accéder aux points de terminaison des services de jeux Play, tels que la procédure de connexion.

Les utilisateurs disposant de comptes de test autorisés auront accès à votre projet de jeu non publié dans les services de jeux Play et pourront vérifier que vos services de jeux Play configurés fonctionnent correctement.

Il existe deux façons d'autoriser les testeurs à utiliser les API des services de jeux Play pour votre jeu :

  • Au niveau individuel, en ajoutant chaque adresse e-mail souhaitée.

  • Au niveau d'un groupe, en activant les services de jeux Play pour un canal de publication Play Console.

Pour ajouter des testeurs individuellement à votre projet de jeu :

  1. Ouvrez l'onglet Testers (Testeurs) pour votre jeu dans la Google Play Console (Grow > Play Games Services > Setup and management > Testers [Développement > Services de jeux Play > Configuration et gestion > Testeurs]).
  2. Cliquez sur le bouton Add testers (Ajouter des testeurs).
  3. Dans la boîte de dialogue qui s'affiche, saisissez les adresses e-mail des comptes Google que vous souhaitez ajouter en tant que testeurs (séparées par une virgule ou un saut à la ligne).
  4. Cliquez sur Add (Ajouter) pour enregistrer les utilisateurs en tant que testeurs. Les comptes de testeurs que vous avez ajoutés devraient pouvoir accéder aux services de jeux Play d'ici quelques heures.

Pour autoriser l'accès à un groupe de testeurs, activez un canal de publication afin d'accéder aux services de jeux Play :

Google Play vous permet de distribuer facilement des versions préliminaires de votre application à des groupes d'utilisateurs de confiance contrôlés à l'aide des fonctionnalités de canal de publication. Consultez Configurer un test ouvert, fermé ou interne sur le site Web d'aide Google Play.*

Vous pouvez accorder l'accès à votre jeu à tous les utilisateurs ayant accès aux fichiers APK de test sur un canal de publication donné. Ceci fonctionne de la même façon que si vous les aviez ajoutés individuellement à la liste des testeurs. Pour ce faire, procédez comme suit :

  1. Ouvrez la section PGS Testers (Testeurs PGS) (Grow > Play Games Services > Setup and management > Testers [Développement > Services de jeux Play > Configuration et gestion > Testeurs]) et sélectionnez l'onglet Canaux de publication. Sur cette page, vous pouvez également consulter la liste des canaux déjà activés pour les tests des services de jeux Play.
  2. Cliquez sur Add tracks (Ajouter des canaux).
  3. Sélectionnez un ou plusieurs canaux pour activer les tests des services de jeux Play.
  4. Cliquez sur Add Tracks (Ajouter des canaux).

Les canaux de publication sélectionnés apparaissent désormais dans la liste des canaux activés pour les tests de services de jeux Play.

Cette fonctionnalité n'est disponible que si une application Android est associée à votre jeu dans la Google Play Console.

Éviter les problèmes courants

Pour éviter les erreurs de configuration les plus fréquentes, veillez à suivre ces recommandations lorsque vous configurez votre jeu pour utiliser les services de jeux Google Play.

1. Configurez votre jeu avec la Play Console.
Si vous avez créé un identifiant de client OAuth 2.0 pour votre application dans la console Google Cloud, les services de jeux Google Play ne pourront pas faire le lien entre l'identifiant de client et les réussites et classements du jeu. Pour permettre cette association, vous devez créer un identifiant à l'aide de l'identifiant de client OAuth 2.0, comme décrit dans Créer un identifiant.
2. Utilisez l'identifiant d'application correct dans Android.
L'identifiant application est une ressource de chaîne obligatoire que vous devez inclure dans le fichier manifeste Android. La chaîne d'identifiant d'application ne comprend que les chiffres (au moins 12, généralement) placés en tête de l'identifiant de client fourni par la Play Console. L'identifiant d'application se trouve en haut de la page Configuration et comporte un libellé d'identifiant de projet sous le nom de votre jeu.
3. Signez votre APK avec le bon certificat.
Lorsque vous associez votre application Android à votre jeu dans la Play Console, vous devez reprendre exactement le même nom de package et la même empreinte du certificat que ceux que vous avez utilisés pour publier votre application. Si ce n'est pas le cas, les appels aux services de jeux Google Play échoueront. Vous devez créer deux identifiants de client, l'un avec l'empreinte du certificat de version et l'autre avec l'empreinte du certificat de débogage, et utiliser le même nom de package pour les deux. Pour savoir comment indiquer le certificat de signature dans la Play Console, consultez la page Signer vos applications.
4. Lorsque vous développez pour Android, incluez le SDK Play Jeux en tant que projet de bibliothèque, et non en tant que projet JAR autonome.
Assurez-vous que le SDK des services Google Play est référencé en tant que projet de bibliothèque dans votre projet Android. Sinon, des erreurs risquent de se produire quand votre application ne trouvera pas les ressources des services Google Play. Pour savoir comment configurer votre projet Android pour utiliser les services Google Play, consultez Configurer les services Google Play.
5. Connectez-vous avec un compte de testeur pendant le développement.
Si vous n'avez pas publié les modifications apportées à vos paramètres de jeu dans la Play Console, vous pouvez rencontrer des erreurs lors des tests si vous n'êtes pas connecté avec un compte de testeur figurant sur la liste blanche. Vous devez toujours activer votre compte d'éditeur Play Console pour les tests. Pour savoir comment gérer les comptes de testeur, consultez la page Activer les comptes de test.
6. Publiez l'écran de consentement dans Google Cloud Platform.
Avant de publier l'application dans la Play Console, publiez l'écran de consentement dans Google Cloud Platform. Sans cette étape, l'audience publique ne pourra pas utiliser les fonctionnalités des services de jeux Play.
7. Publiez les paramètres des services de jeux Play avant de publier votre jeu.
Les développeurs peuvent publier accidentellement leur application sans publier les paramètres des services de jeux Play correspondants. Les joueurs qui se connectent avec un compte non testeur pourraient alors rencontrer des erreurs, car l'application ne sera pas en mesure d'identifier les paramètres de jeu appropriés. Lorsque vous publiez votre jeu, n'oubliez pas de publier les paramètres associés via l'option Publier le jeu dans la Play Console. Pour savoir comment publier vos modifications, consultez la page Publier les modifications apportées à votre jeu.

Pour obtenir des conseils supplémentaires, consultez le guide de dépannage Android.

Étapes suivantes

Une fois les tâches de configuration initiale décrites ci-dessus terminées, vous pouvez activer les fonctionnalités des services de jeux Play pour votre jeu, telles que l'enregistrement des sessions, les classements et les réussites.