Créer et gérer des applis connectées à l'aide d'AppFunctions et d'Android MCP dans la console Google Connected

Utilisez la Google Connected Console pour intégrer les AppFunctions de votre application Android sur l'appareil à Gemini sur Android. En créant une application connectée avec le type de connexion MCP Android et en l'associant à votre application Play, vous permettez à Gemini sur Android de déclencher des actions et d'effectuer des tâches directement dans votre application au nom des utilisateurs.

Ce guide vous présente le workflow en libre-service de bout en bout dans la Google Connected Console, y compris la création d'une application connectée, l'association d'une application Play, la configuration d'une fiche d'application publique, l'importation et l'envoi d'un app bundle, les tests d'aperçu sur l'appareil et la publication en production.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Accès à un compte de développeur enregistré dans la console Google Connected :
  • Acceptation des conditions d'utilisation : la première fois que votre organisation accède aux Applis connectées dans la console Google Connected, le titulaire du compte ou un administrateur doit lire et accepter les conditions d'utilisation des Applis connectées avant que les membres de l'équipe puissent créer des applications connectées.
  • Autorisations utilisateur : si vous avez été invité à rejoindre un compte de développeur Connected Console existant, mais que vous ne pouvez pas créer d'applications connectées, demandez au titulaire ou à l'administrateur du compte de vous accorder l'autorisation Afficher les applications connectées ou Créer et gérer des applications connectées sur la page Utilisateurs et autorisations. Vous devez également disposer des autorisations de gestion des versions pour l'application Play concernée afin d'importer des app bundles et de gérer les versions.
• Une application Play existante dans votre compte Google Connected Console :
  • Votre application Play doit déjà exister dans le même compte de développeur pour que vous puissiez l'associer à votre application connectée. Chaque application Play ne peut être associée qu'à une seule application connectée Android MCP.
  • Assurez-vous que votre application Play dispose d'une fiche Play Store par défaut configurée avec une icône d'application et des langues compatibles. Les langues de la fiche Play Store de votre application et le ciblage géographique déterminent où votre application connectée au MCP Android est disponible.
• Un Android App Bundle (.aab) avec des AppFunctions implémentées :
  • Configurez votre app bundle pour cibler les appareils mobiles Android, qui sont la plate-forme compatible avec l'intégration de l'application Gemini sur l'appareil.
• Catégorie d'application connectée et métadonnées publiques : préparez les éléments et les informations qui constituent la présence publique de votre application connectée :
  • Catégorie d'applications connectées : domaine ou catégorie sectorielle de votre application connectée. Chaque catégorie définit des exigences de base en termes de fonctionnalités et ne peut pas être modifiée après sa création.
  • Nom de l'application : nom à afficher de votre application connectée, présenté aux utilisateurs dans les produits Google et utilisé lorsqu'ils mentionnent votre application avec @ dans Gemini.
  • Icône de l'application connectée : icône d'application de 512 x 512 px au format JPEG ou PNG, d'une taille maximale de 1 Mo (1 024 Ko).
  • Description de l'application : résumé concis décrivant ce que votre application connectée peut faire pour les utilisateurs.
  • Fonctionnalités de l'application : au moins trois fonctionnalités personnalisées qui montrent aux utilisateurs ce que votre application peut faire lorsqu'ils décident de la connecter, en plus des fonctionnalités par défaut définies par la catégorie de votre application.
  • Exemples de prompts : au moins trois exemples de prompts qui expliquent aux utilisateurs comment appeler votre application dans Gemini et les aident à comprendre ce qu'ils peuvent demander.
  • URL des règles : URL accessible au public pour vos règles de confidentialité.
  • URL des conditions d'utilisation : URL accessible au public pour vos conditions d'utilisation.
  • URL du site Web (facultatif) : URL accessible au public pointant vers votre site Web pour l'attribution.

Enregistrer, tester et publier des AppFunctions avec Gemini

Une fois que vous avez rempli les conditions préalables, suivez les étapes ci-dessous pour enregistrer votre application connectée Android MCP, associer votre application Play, renseigner les informations sur l'application, importer et envoyer vos AppFunctions, effectuer des tests sur l'appareil et publier en production.

Étape 1 : Créez une application connectée MCP Android et associez-la à votre application Play

Pour créer une application connectée et l'associer à votre application Play, procédez comme suit :

1. Connectez-vous à la Google Connected Console.
2. Sur la page Accueil, sélectionnez Créer une application.
3. Dans la boîte de dialogue Choisir ce que vous souhaitez créer :
   • Si vous êtes invité à accepter les conditions d'utilisation des applications connectées, sélectionnez Afficher les conditions, lisez et acceptez le contrat, puis sélectionnez Créer. Seul un administrateur du compte peut accepter l'accord.
   • Sinon, sélectionnez Créer dans la fiche Application connectée.
4. Dans la boîte de dialogue Donnez un nom à votre application connectée, saisissez un nom pour votre application connectée. Il s'agit du nom qui affiche votre application connectée dans les produits Google et de la façon dont les utilisateurs mentionnent votre application connectée à l'aide de @. Cliquez sur Suivant.

5. Dans la boîte de dialogue Sélectionner une catégorie d'application connectée, sélectionnez le domaine, la catégorie ou le secteur de votre application dans le menu Sélectionner une catégorie.

6. Dans la boîte de dialogue Choose connection type (Choisir le type de connexion), sélectionnez Android MCP.

   Pour obtenir une présentation détaillée de la configuration d'une application connectée à un serveur MCP, consultez le guide d'intégration de la Google Play Console. Pour l'instant, vous ne pouvez choisir qu'un seul type de connexion par application connectée, et vous ne pourrez pas le modifier ultérieurement.

7. Sélectionnez Créer une application connectée.

8. Dans la boîte de dialogue Sélectionner une application, recherchez l'application Play qui contient (ou contiendra) vos AppFunctions, puis sélectionnez-la. Vous pouvez filtrer la liste à l'aide de la recherche.

   • Les applications Play déjà associées à une autre application connectée ne peuvent pas être sélectionnées.
   • Assurez-vous de sélectionner l'application Play que vous souhaitez associer. Une fois que vous avez sélectionné une application Play, vous ne pouvez plus la modifier.

La page de présentation de la gestion de votre appli connectée s'ouvre. Vous pouvez y continuer à configurer les détails de votre appli connectée, suivre ses versions et gérer les testeurs.

Étape 2 : Fournissez des informations sur votre application connectée

Avant d'importer des app bundles contenant des AppFunctions, configurez la façon dont votre application connectée apparaît aux utilisateurs dans Gemini.

Pour fournir les détails de votre application connectée, procédez comme suit :

1. Sur la page de gestion de votre application connectée, dans la fiche Android MCP sous Ajouter les informations sur l'application connectée, sélectionnez Ajouter les informations sur l'application (ou Gérer si vous mettez à jour des informations existantes).
2. En haut de la page Détails de l'application, vérifiez le champ Nom de l'application connectée. Vous pouvez modifier le nom si nécessaire. Il est visible par les utilisateurs dans les produits Google et utilisé lorsqu'ils mentionnent votre application avec @.
3. Dans la section Informations publiques, sous Icône, importez l'icône de votre application (JPG ou PNG, jusqu'à 1 Mo et 512 px x 512 px).

4. Remplissez les champs suivants :

   • Description : saisissez un résumé concis d'une seule phrase (moins de 30 mots) décrivant les principales fonctionnalités de votre application connectée et ce qu'elle peut faire. Ce texte est présenté aux utilisateurs et n'est pas utilisé comme instructions du modèle.
   • Fonctionnalités : saisissez au moins trois tâches à forte valeur ajoutée que votre application connectée peut effectuer. Sélectionnez Ajouter une fonctionnalité pour ajouter d'autres entrées. N'incluez pas de chiffres au début de vos fonctionnalités. N'incluez qu'une seule fonctionnalité par entrée. Si la catégorie de votre application connectée inclut des fonctionnalités prédéfinies, elles s'affichent en haut de la liste et ne peuvent pas être modifiées.
   • Exemples de prompts : saisissez au moins trois exemples de prompts pour aider les utilisateurs à comprendre ce qu'ils peuvent demander. Sélectionnez Ajouter un exemple de prompt pour ajouter des entrées.
     • Commencez au moins deux prompts par @<YourAppName> (par exemple, @Order Tracker where is my last order?).
     • Mentionnez <YourAppName> naturellement dans au moins un prompt sans commencer par le nom de votre application (par exemple, Track my recent order on Order Tracker).
     • N'incluez pas de préfixes numérotés (1., 2., 3.) et ne placez pas les requêtes entre guillemets ("...").

   • Localisation multilingue : pour fournir des traductions pour les champs Description, Capacités et Exemples de requêtes, encapsulez le texte de chaque paramètre régional dans des balises de langue dans le champ de saisie. Exemple :

     <en-US>
     Play music, manage playlists, and discover artists
     </en-US>
     <es-ES>
     Reproduce música, gestiona listas y descubre artistas
     </es-ES>
     

     Connected Console valide automatiquement vos balises et affiche les paramètres régionaux détectés sous chaque champ (par exemple, Found translations for 2 languages: en-US, es-ES).

   • URL des conditions d'utilisation : saisissez un lien https:// ou http:// valide vers vos conditions d'utilisation.

   • URL des règles : saisissez un lien https:// ou http:// valide vers vos règles de confidentialité.

   • URL du site Web (facultatif) : saisissez un lien vers votre site Web à des fins d'attribution.

Étape 3 : Importez un app bundle contenant vos AppFunctions et envoyez votre application connectée

Après avoir enregistré les détails de votre application connectée, importez un Android App Bundle contenant vos AppFunctions dans votre application Play associée, puis envoyez la version de l'application connectée pour la tester.

Pour importer un app bundle contenant vos AppFunctions, procédez comme suit :

1. Sur la page de gestion de votre application connectée, dans la fiche Android MCP, sous Importer un app bundle contenant vos AppFunctions, sélectionnez Importer un app bundle pour accéder à la vue d'ensemble Tester et publier de votre application Play associée.
2. Vous pouvez également ouvrir votre application Play associée directement dans la console Google Connected. Dans le menu de navigation de gauche de votre application Play, accédez à Tests > Tests internes (ou un autre canal de test), puis sélectionnez Créer une version (ou Modifier la version si vous disposez déjà d'une version brouillon).
3. Sous App bundles, sélectionnez Importer pour importer votre bundle .aab avec AppFunctions, ou sélectionnez Ajouter depuis la bibliothèque si vous avez importé le bundle après avoir terminé l'étape 2.
4. Une fois l'importation terminée, accédez à la section Fonctionnalités de l'appli détectées dans votre app bundle sur la page de la version. Vérifiez que le nom de votre application connectée, le code de version du bundle, le nombre d'outils détectés, le nombre de langues et le ciblage géographique de l'application Play s'affichent comme prévu, et vérifiez que les contrôles automatisés ne signalent aucun problème. (Si des erreurs de validation s'affichent, suivez les instructions de la section Résoudre les problèmes liés à AppFunctions avant de continuer.)
5. En bas de la page de la version, sélectionnez Envoyer l'application connectée et continuer.

Si vous sélectionnez Envoyer l'application connectée et continuer, votre version d'AppFunctions est envoyée à Gemini pour des tests de prévisualisation, et votre version Play passe à la page de prévisualisation de la version. Si vous souhaitez itérer sur les AppFunctions à l'aide de builds locaux sans incrémenter le code de version de votre app bundle, laissez la version Play à l'état de brouillon et ne sélectionnez pas Enregistrer et publier. La publication d'une version Play verrouille le code de version de ce bundle, qui ne peut plus être supprimé ni réimporté. Toute modification ultérieure nécessite un code de version d'app bundle incrémenté. (Si vos testeurs installent l'application directement depuis le canal de test interne de Google Play plutôt que de la charger de manière indépendante, effectuez le déploiement du test interne et incrémentez votre code de version lors des prochaines importations.)

Étape 4 : Vérifiez la version de votre application connectée

Après avoir envoyé votre application connectée depuis la page de publication Play, vérifiez que la version de l'application connectée est prête pour l'aperçu :

1. Sur la page de gestion de votre application connectée, dans la fiche Android MCP, à côté de Versions, sélectionnez Afficher.
2. Sur la page Versions, vérifiez que la version que vous avez envoyée apparaît dans la section Disponible pour les testeurs (avec la mention Version <N> • Submitted <Date> • Using AppFunctions from app bundle <versionCode>).
   • Sélectionnez Afficher sur n'importe quelle ligne de version pour inspecter les AppFunctions détectées et l'instantané en lecture seule des informations sur l'application capturé pour cette version.
   • Les versions créées à partir d'un app bundle importé pour lequel vous n'avez pas encore sélectionné Envoyer l'appli connectée et continuer s'affichent sous En attente d'envoi.

Étape 5 : Testez votre application connectée

Pour que votre appli connectée soit disponible pour les testeurs, vous devez les ajouter sur la page Gérer les testeurs. Seuls les utilisateurs que vous ajoutez à votre liste de testeurs peuvent voir votre application connectée non publiée et interagir avec elle. Vous ne pouvez ajouter que des testeurs disposant d'un compte @gmail.com.

1. Sur la page de présentation de votre appli connectée, dans la fiche Tester votre appli, sélectionnez Ajouter des testeurs (ou Gérer les testeurs si vous en avez déjà ajouté).
2. Sur la page Gérer les testeurs, sélectionnez des listes de diffusion existantes ou sélectionnez Créer une liste de diffusion pour ajouter les comptes Google autorisés à tester votre intégration. Veillez à inclure votre propre adresse e-mail si vous souhaitez tester l'application vous-même.

3. Sélectionnez Enregistrer.

4. Les testeurs de l'application Gemini peuvent appeler votre application connectée en saisissant @ suivi du nom de votre application connectée et en la sélectionnant dans le menu. Vous pouvez également afficher et connecter votre application dans Gemini en accédant à Paramètres et aide > Applications connectées dans la barre de navigation de gauche.

Avant de tester l'application sur l'appareil, vérifiez que chaque testeur remplit les conditions suivantes :

• Connecté sur un téléphone ou une tablette Android à l'aide d'un compte Google inclus dans la liste d'adresses e-mail configurée à l'étape 5.
• Exécuter la compilation exacte de l'application Android dont le code de version du bundle correspond à la version envoyée à l'étape 4.

Nous vous recommandons de tester minutieusement votre intégration :

• Essayez tous vos exemples de prompts.
• Testez les appels @<AppName> explicites et les requêtes en langage naturel.
• Vérifiez la gestion des paramètres de l'outil, les invites de confirmation et l'exécution de bout en bout de vos AppFunctions.

Une fois que vous êtes satisfait de vos tests, vous pouvez envoyer votre application connectée à Google pour examen.

Étape 6 : Publiez votre application connectée pour les utilisateurs

Contrairement aux intégrations MCP hébergées sur un serveur, une application connectée Android MCP ne nécessite pas d'examen ni d'action de publication distincts sur la page de gestion des applications connectées. À la place, la version de votre application connectée est examinée par Google et publiée automatiquement lorsque vous publiez en production la version de l'application Play contenant votre app bundle AppFunctions.

Une fois les tests terminés et lorsque vous êtes prêt à lancer l'application auprès des utilisateurs :

1. Dans la Google Connected Console, ouvrez votre application Play associée, puis accédez à Version > Production dans le menu de navigation de gauche (ou promouvez votre version testée d'un canal de test vers la Production).
2. Sélectionnez Créer une version (ou modifiez une version de production existante) et ajoutez l'app bundle contenant vos AppFunctions validées à l'aide de Ajouter depuis la bibliothèque ou Importer.
3. Accédez à la section Des AppFunctions ont été détectées dans votre app bundle pour confirmer la version de votre application connectée, le nombre d'outils, le nombre de langues de la fiche Play Store et le ciblage par pays de l'application Play, et assurez-vous que les vérifications automatisées n'indiquent aucun problème bloquant.
4. Sélectionnez Envoyer l'application connectée et continuer, renseignez les détails de votre version, puis envoyez votre version en production de l'application Play pour examen et déploiement.

Une fois que la version en production de votre application Play est approuvée et déployée :

• Votre application connectée MCP Android devient disponible dans Gemini sur Android pour les utilisateurs des pays et des langues ciblés par votre application Play.
• Sur la page de gestion de votre application connectée (Applications connectées > Gérer), la fiche État de l'application connectée passe à Publiée, affichant le code de version de l'app bundle en ligne et la date de publication. La version apparaît sous Publiée sur la page Versions.
• Pour publier ultérieurement des outils AppFunctions mis à jour, créez un app bundle avec un code de version incrémenté, testez-le à l'aide d'un canal de test, puis publiez une nouvelle version Production sur Play. Si vous souhaitez également mettre à jour les métadonnées publiques de votre application connectée (telles que les capacités ou les exemples de prompts), enregistrez ces modifications sous Applis connectées > Gérer > Informations sur l'application avant d'importer votre nouvel app bundle.

Mettre à jour votre app bundle pour ajuster les AppFunctions

Si vous souhaitez itérer sur AppFunctions lors des tests internes sans incrémenter le code de version de votre application Android, vous pouvez supprimer un app bundle brouillon non publié avant de le réimporter :

1. Mettez à jour l'implémentation d'AppFunctions dans votre projet Android et générez un nouvel app bundle .aab.
2. Supprimez l'app bundle précédent de toutes les versions brouillons auxquelles vous l'avez ajouté :
   1. Ouvrez votre application Play associée dans la Google Play Console et sélectionnez Tests internes (ou le canal contenant votre version brouillon) dans le menu de navigation de gauche.
   2. Sur votre version brouillon, sélectionnez Modifier la version.
   3. Recherchez l'app bundle, sélectionnez le menu à trois points (⋮), puis sélectionnez Supprimer l'app bundle.
   4. Sélectionnez Enregistrer comme brouillon.
3. Supprimez l'app bundle inutilisé de votre bibliothèque :
   1. Dans le menu de navigation de gauche de votre application Play, sélectionnez Dernières versions et bundles (si le bundle n'apparaît pas, sélectionnez Afficher tous les app bundles).
   2. Ouvrez les détails de votre app bundle et, si le bouton Supprimer l'app bundle est disponible, sélectionnez Supprimer l'app bundle. Cela libère le code de version, ce qui vous permet d'importer l'app bundle mis à jour sans incrémenter le code de version.
4. Si l'option Supprimer l'app bundle n'est pas disponible (par exemple, parce que la version a déjà été publiée sur un canal), incrémentez le versionCode dans la configuration de compilation de votre application, générez un nouvel app bundle, puis importez et envoyez la nouvelle version comme décrit à l'étape 4.

Résoudre les problèmes liés à AppFunctions

Suivez les instructions ci-dessous pour résoudre les erreurs de vérification automatique et les problèmes de configuration courants.

Résoudre les erreurs de vérification automatisée sur une version

Tous les problèmes identifiés par les vérifications automatisées d'AppFunctions s'affichent sur la page de préparation de la version (par exemple, Créer une version de test interne) et dans la section Échec (avec un badge Résoudre les problèmes pour publier) sur la page Versions de votre application connectée.

Si les vérifications automatiques signalent des problèmes avec votre app bundle, procédez comme suit :

1. Corrigez les problèmes sous-jacents liés aux AppFunctions dans le code de votre application Android et créez un app bundle mis à jour.
2. Si votre version précédente est toujours un brouillon et que vous souhaitez réutiliser le même code de version :
   1. Dans le menu de navigation de gauche de votre application Play, sélectionnez Tests internes (ou le canal approprié), puis Modifier la version sur votre version brouillon.
   2. Sélectionnez le menu à trois points (⋮) à côté de l'app bundle, puis sélectionnez Supprimer l'app bundle.
   3. Sélectionnez Enregistrer comme brouillon.
   4. Dans le menu de navigation de gauche, sélectionnez Dernières versions et bundles (sélectionnez Afficher tous les app bundles si nécessaire), sélectionnez le bundle, puis Supprimer l'app bundle.
   5. Revenez à votre version brouillon, importez l'app bundle corrigé, puis sélectionnez Envoyer l'application connectée et continuer.
3. Si vous ne pouvez pas supprimer le bundle précédent, incrémentez le versionCode de votre app bundle, importez le nouveau bundle dans votre version, puis sélectionnez Envoyer l'application connectée et continuer.

Problèmes courants de configuration et d'intégration

Le tableau suivant décrit les problèmes courants que vous pouvez rencontrer lors de la configuration de l'application connectée, de l'importation du bundle ou des tests, ainsi que leurs causes et leurs solutions :

Problème	Message de la console ou symptôme	Cause	Solution
App bundle importé avant de créer ou d'associer une application connectée	La page "Version" affiche Créer ou associer une application connectée.	Le fichier .aab importé contient des AppFunctions, mais l'application Play n'est pas encore associée à une application connectée Android MCP.	Suivez les étapes 1 à 3 pour créer une application connectée, sélectionnez Android MCP, associez votre application Play et enregistrez les informations sur l'application. Ensuite, supprimez et réimportez l'app bundle, ou importez un nouvel app bundle avec un versionCode incrémenté.
App bundle importé avant l'enregistrement des informations sur l'application connectée	La page "Version" affiche Informations sur l'application connectée requises et un bouton Fournir des informations sur l'application connectée.	L'application Play est associée à une application connectée MCP Android, mais les champs obligatoires de la page Informations sur l'application n'ont pas été enregistrés avant l'importation du bundle.	Sélectionnez Fournir les informations sur l'application connectée (ou accédez à Applis connectées > Gérer > Ajouter les informations sur l'application), remplissez et enregistrez tous les champs obligatoires, puis supprimez et réimportez le bundle ou importez un nouveau bundle avec un versionCode incrémenté.
Impossible de sélectionner l'application Play lors de l'association	L'application Play cible affiche un badge Déjà associée ou n'apparaît pas dans la boîte de dialogue Sélectionner une application.	Chaque application Play ne peut être associée qu'à une seule application connectée MCP Android, ou l'application Play n'a pas encore été créée dans ce compte de développeur.	Vérifiez les entrées existantes sous Applications connectées pour voir si une autre application connectée est déjà associée à votre application Play, ou créez d'abord l'application Play dans la Google Connected Console avant de l'associer.
Impossible de créer une application connectée	L'option permettant de créer une appli connectée n'existe pas, ou la création d'une appli connectée affiche un avertissement concernant les autorisations ou les conditions d'utilisation.	Votre compte utilisateur ne dispose pas des autorisations nécessaires pour les applications connectées, ou un titulaire ou un administrateur du compte n'a pas encore accepté les conditions d'utilisation des applications connectées.	Demandez au titulaire du compte ou à l'administrateur d'accepter les Conditions d'utilisation des Applis connectées et d'accorder à votre compte l'autorisation Afficher les Applis connectées ou Créer et gérer des Applis connectées sur la page Utilisateurs et autorisations.
La version de l'application connectée est bloquée sur l'état "En attente d'envoi"	Sur la page Applis connectées > Gérer > Versions, la version de votre bundle apparaît sous En attente d'envoi au lieu de Disponible pour les testeurs.	La Google Connected Console a détecté des AppFunctions dans le bundle que vous avez importé, mais la version de l'appli connectée n'a pas été envoyée depuis la page de la version.	Ouvrez la version de l'application Play contenant ce bundle, puis sélectionnez Envoyer l'application connectée et continuer pour que les testeurs puissent la prévisualiser.
Exemple d'erreur de validation des requêtes sur la page d'informations de l'application	Le formulaire Fiche d'application publique ne peut pas être enregistré et affiche une erreur sous Exemples de requêtes.	Les requêtes ne respectent pas les règles de mise en forme ou de mention, ou le nom de l'application a été modifié après la rédaction des requêtes.	Fournissez trois à quatre prompts au total : commencez au moins deux d'entre eux par @<YourAppName>, mentionnez <YourAppName> naturellement sans @ dans au moins un prompt, et supprimez les préfixes numérotés (1., 2.) ou les guillemets ("...").
L'appli connectée n'est pas visible par les testeurs dans Gemini sur Android	Les testeurs ne trouvent pas l'appli connectée sous Applis connectées ni en utilisant une mention @ dans l'application Gemini pour Android.	La propagation est toujours en cours, le compte du testeur n'est pas éligible ou la version de l'application installée ne correspond pas.	Attendez environ 20 minutes après l'envoi (et jusqu'à 10 minutes après avoir enregistré les testeurs). Vérifiez que le testeur utilise un compte @gmail.com personnel figurant sur la liste d'adresses e-mail enregistrée, qu'il utilise un téléphone ou une tablette Android, et qu'il a installé la version exacte du bundle envoyé.