Ajouter Firebase à votre application Google AI Studio

Le mode Créer dans Google AI Studio peut configurer et intégrer automatiquement les services Firebase dans vos applications Web et applications Android :

• Cloud Firestore et Firebase Authentication (pour les applications Web et Android) pour créer des applications avec un stockage persistant des données et des flux de connexion sécurisés.
• Firebase AI Logic et Firebase App Check (pour les applications Android) pour appeler de manière sécurisée les modèles Gemini directement depuis votre application mobile sans exposer les clés API.

En une seule requête et en quelques clics, vous permettez à l'agent Google AI Studio de configurer un projet Firebase, d'associer votre application à ce projet et de générer le code et les fichiers de configuration Firebase nécessaires directement dans votre application.

Pour en savoir plus sur la création d'applications Web full stack et d'applications Android, consultez la documentation Google AI Studio.

Présentation : Ajouter un backend à votre application Google AI Studio

1. Décrivez votre idée : créez une application dans Google AI Studio et décrivez une fonctionnalité qui nécessite une base de données, une authentification ou l'IA générative (pour les applications Android). Par exemple, vous pouvez saisir une requête comme celle-ci :

   • Build a shared to-do list app using Firebase as a backend.
   • Build an Android recipe app that uses Firebase AI Logic to suggest meals from ingredients.

2. Activez l'intégration Firebase : dans la fiche qui s'affiche, configurez votre installation :

   1. Personnaliser le projet ou l'emplacement (facultatif) : cliquez sur l'icône Paramètres settings, puis sélectionnez un emplacement ou le projet Google Cloud que vous souhaitez utiliser.

   2. Confirmez votre sélection : pour continuer, cliquez sur le bouton Activer Firebase.

   L'agent configure ensuite automatiquement les services Firebase applicables dans votre projet Firebase, associe votre application à votre projet Firebase et génère le code et les fichiers de configuration Firebase applicables :

   • Applications Web :

     • Services possibles : Cloud Firestore, Authentication et Firebase Security Rules
     • Les fichiers incluent /src/lib/firebase.ts et firestore.rules

   • Applications Android :

     • Services possibles : Cloud Firestore, Authentication et Firebase Security Rules ; si votre application utilise des fonctionnalités d'IA : Firebase AI Logic et Firebase App Check
     • Les fichiers incluent google-services.json, firestore.rules et firebase_applet_config.xml.

3. Déployer ou publier : une fois que vous êtes prêt, vous pouvez déployer ou publier votre application :

   • Applications Web : utilisez l'option Partager > Publier pour déployer votre application Web sur Cloud Run. Votre application sera automatiquement déployée dans le projet que vous avez sélectionné lors de la configuration.
   • Applications Android : installez l'application sur un appareil physique via USB pour effectuer des tests en local ou publiez-la auprès de testeurs spécifiques dans Google Play pour effectuer des tests internes.

   Avant de partager, de déployer ou de publier votre application, veillez également à examiner le Firebase Security Rules généré par l'IA.

Ajouter Firebase à une application pendant le développement

Si vous souhaitez ajouter l'intégration Firebase à une application sur laquelle vous travaillez dans Google AI Studio, vous pouvez le faire à tout moment pendant la phase d'itération en utilisant l'une des options suivantes :

• Parlez à l'agent : demandez à l'agent d'ajouter une fonctionnalité qui nécessite une base de données, une authentification ou une IA générative pour Android (par exemple, Add a Firestore database to this app ou Add Firebase AI Logic to summarize notes).
• Utiliser le menu des paramètres : accédez à Paramètres > Intégrations, puis cliquez sur la tuile Firebase Firestore et Auth.

Les deux options lancent le processus de configuration de l'intégration Firebase, ce qui vous permet de sélectionner un projet, de configurer l'emplacement de votre backend et d'activer l'intégration pour votre application, comme décrit dans la présentation.

Une fois l'intégration activée, vous pouvez consulter sa configuration (y compris le projet, l'emplacement, l'adresse e-mail d'assistance de l'application et l'ID de la base de données) à tout moment en accédant à Paramètres > Intégrations et en cliquant sur la tuile Firebase Firestore et Auth.

Comprendre le quota partagé pour Cloud Firestore

Selon la date de création de votre application, l'éligibilité de votre compte et votre plate-forme (le niveau Starter n'est pas disponible pour les applications Android), vos bases de données peuvent être hébergées dans un projet Google Cloud de niveau Starter ou un projet standard. Toutefois, dans les deux cas, toutes les bases de données Cloud Firestore provisionnées par l'agent Google AI Studio sont placées dans le même groupe de bases de données "Quota partagé d'IA" de votre projet. Ils partagent tous les caractéristiques suivantes :

• Quota partagé : toutes les bases de données du groupe partagent un quota d'utilisation (voir les détails ci-dessous).
• Aucun compte Cloud Billing requis : vous pouvez créer et tester votre application sans ajouter de facturation. Consultez les détails ci-dessous pour savoir comment ajouter la facturation (facultatif).
• Réinitialisations quotidiennes : si vous atteignez une limite de quota quotidien (par exemple, 50 000 lectures/jour), le service sera suspendu pour toutes les bases de données du groupe et reprendra le lendemain vers minuit, heure du Pacifique.

Les bases de données Cloud Firestore du groupe de quota partagé sont soumises aux limites suivantes :

(Facultatif) Ajoutez la facturation pour obtenir plus de quota Cloud Firestore

Si votre application gagne en popularité et que vous devez dépasser les limites sans frais pour Cloud Firestore, vous pouvez ajouter la facturation, ce qui met à niveau votre projet Firebase vers le forfait Blaze avec paiement à l'usage.

Vous avez peut-être déjà ajouté la facturation à votre projet pour différentes raisons, par exemple pour utiliser Nano Banana. Si tel est le cas, votre projet est déjà associé au forfait Blaze. Vous pouvez passer directement à l'étape de mise à niveau de la base de données.

Étape 1 : Ajoutez la facturation (si ce n'est pas déjà fait).

Vous pouvez configurer la facturation directement dans Google AI Studio.

1. Dans Google AI Studio, accédez à la page Projets.
2. Cliquez sur Configurer la facturation à côté du projet que vous souhaitez mettre à niveau.
3. Suivez les instructions à l'écran pour sélectionner votre pays, accepter les conditions d'utilisation et ajouter un mode de paiement ou sélectionner un compte de facturation existant. Il est également possible qu'un prépaiement vous soit demandé (il ne s'applique pas à l'utilisation des services Firebase et Google Cloud).

Étape 2 : Mettre à niveau la base de données

Même après l'ajout de la facturation, les bases de données Cloud Firestore créées par l'agent Google AI Studio restent dans le groupe de quotas partagés. Pour activer le scaling payant complet pour une base de données spécifique, vous devez la mettre à niveau manuellement.

1. Accédez à la console Firebase et sélectionnez le projet contenant la base de données que vous souhaitez mettre à niveau.
2. Dans le volet de navigation de gauche, accédez à Bases de données et stockage > Firestore.
3. Si votre projet contient plusieurs instances de base de données Cloud Firestore, sélectionnez celle que vous souhaitez mettre à niveau.
4. Recherchez une bannière en haut de la page indiquant que la base de données est soumise à des limites de quota partagé d'IA. Pour la mettre à niveau, cliquez sur Mettre à niveau la base de données > Passer au paiement à l'usage.Si cette bannière ne s'affiche pas, cela signifie que la base de données n'a pas été créée par l'agent Google AI Studio et ne fait pas partie du groupe de quotas partagés, ou qu'elle a déjà été mise à niveau.

La modification visant à désactiver le quota partagé et à activer la facturation en paiement à l'usage pour votre base de données devrait prendre effet dans quelques minutes.

Génération Security Rules

L'agent Google AI Studio génère automatiquement Firebase Security Rules en fonction de la logique de votre application. Ces Security Rules sont conçues pour être "refusées par défaut", ce qui signifie que les utilisateurs finaux de votre application ne peuvent accéder qu'aux données qui leur appartiennent.

Notez que si vous ajustez manuellement votre Security Rules directement dans la console Firebase, l'agent Google AI Studio ne sera pas informé des modifications, et celles-ci seront écrasées lors des itérations ultérieures de l'application. Nous vous recommandons d'utiliser l'agent Google AI Studio pour ajuster votre Firebase Security Rules afin de vous assurer que vos modifications sont conservées et alignées sur la logique de votre application.

Firebase AI Logic et App Check pour les applications Android

Lorsque vous créez une application Android qui inclut des fonctionnalités d'IA générative dans Google AI Studio, l'agent intègre automatiquement Firebase AI Logic et applique Firebase App Check.

Contrairement aux applications Web dans Google AI Studio, qui exécutent les appels de l'API Gemini à partir d'un environnement d'exécution côté serveur sur Cloud Run, les applications Android sont distribuées sous forme de binaires côté client (APK). L'intégration d'une clé API Gemini brute directement dans un APK expose la clé à une extraction et à un potentiel abus de facturation. L'utilisation de Firebase AI Logic avec App Check protège votre projet en vérifiant que les requêtes adressées à l'API Gemini proviennent d'une instance authentique de votre application.

Fonctionnement de App Check dans les environnements de test et de production

Google AI Studio configure App Check pour que votre application fonctionne de manière sécurisée sans configuration manuelle, que vous testiez un prototype ou que vous le publiiez sur Google Play.

• Tests et partage (versions de débogage) : lorsque vous prévisualisez votre application dans l'émulateur Google AI Studio, que vous l'installez sur votre téléphone via USB ou que vous la partagez avec des testeurs de confiance dans Google AI Studio, l'application utilise un jeton de débogage App Check que Google AI Studio gère automatiquement en arrière-plan. Les collaborateurs peuvent tester les fonctionnalités d'IA immédiatement sans voir vos clés API ni vos secrets.
• Publication sur Google Play (versions Release) : lorsque vous créez une version Release pour Google Play, votre application passe automatiquement à reCAPTCHA Enterprise pour l'attestation de production à l'aide d'une clé de site préconfigurée. Vous n'avez pas besoin d'associer manuellement Google Play ni de configurer les fournisseurs App Check avant de publier.

Utiliser un projet existant

Lorsque vous activez l'intégration Firebase pour la première fois, vous pouvez éventuellement sélectionner un projet Google Cloud existant dont vous êtes propriétaire :

1. Dans la fiche qui s'affiche, cliquez sur l'icône Paramètres settings.
2. Sélectionnez votre projet, puis cliquez sur Activer Firebase.

Au fur et à mesure que vous itérez sur votre application, vous pouvez également demander à l'agent d'utiliser un autre projet avec une requête telle que :

Add Firestore to this app using project PROJECT_ID.

Lorsque vous choisissez un projet, les actions suivantes se produisent :

• Une nouvelle base de données Cloud Firestore sera provisionnée dans ce projet à l'aide du quota partagé.
• Firebase Authentication avec Google Sign-In sera configuré.
• Pour les applications Android utilisant l'IA générative, Firebase AI Logic, Firebase App Check et reCAPTCHA Enterprise seront configurés. App Check est automatiquement appliqué pour Firebase AI Logic afin de protéger votre quota d'API.
• Un compte de service sera autorisé à accéder à votre base de données Cloud Firestore. Pour autoriser l'accès administrateur depuis Google AI Studio, un nouveau compte de service nommé ais-sandbox@PROJECT_ID.iam.gservice.com sera autorisé à accéder à votre base de données Cloud Firestore. Ce compte n'est associé qu'à vos applications Google AI Studio.
• Limites : si le projet Firebase dispose déjà d'une base de données Cloud Firestore, l'agent ne pourra pas en ajouter une autre. Vous devrez sélectionner un autre projet ou en créer un vide à utiliser.

Utiliser la console Firebase

Vous pouvez consulter les données et les paramètres de votre application dans la console Firebase. Voici comment accéder au projet Firebase associé à Google AI Studio :

1. Accédez à la consoleFirebase et sélectionnez le projet portant le libellé AI Studio.

2. Dans le volet de navigation de gauche, explorez les services activés dans votre projet :

   • Pour afficher et modifier vos données Cloud Firestore stockées, accédez à Bases de données et stockage > Firestore.
   • Pour afficher ou configurer les paramètres et les données Authentication, accédez à Sécurité > Authentification.
   • Pour surveiller l'utilisation, afficher les quotas ou configurer les paramètres de Firebase AI Logic, accédez à IA > Logique d'IA.
   • Pour gérer l'application de App Check, surveiller les demandes d'attestation ou révoquer des jetons de débogage, accédez à Sécurité > App Check.

Dépannage et questions fréquentes

Trouvez les réponses aux questions fréquentes et découvrez comment résoudre les problèmes lors de l'intégration de Firebase à votre application Google AI Studio.

Comment mon projet et mon emplacement Google Cloud / Firebase sont-ils sélectionnés ?

Lorsque vous demandez un backend Firebase pour une application, vous pouvez éventuellement sélectionner un emplacement et un projet dans la fiche qui s'affiche :

• Personnaliser le projet ou l'emplacement (facultatif) : cliquez sur l'icône Paramètres settings, sélectionnez un emplacement ou le projet Google Cloud que vous souhaitez utiliser, puis cliquez sur Activer Firebase.

Tenez bien compte des éléments suivants :

• L'emplacement de la base de données est définitif : une fois que vous avez sélectionné un emplacement pour votre base de données, vous ne pouvez plus le modifier pour ce projet. Ce choix sera utilisé par défaut pour les autres services de backend.
• Cohérence du projet : pour assurer une intégration parfaite, Google AI Studio utilise automatiquement le même projet pour votre backend et votre déploiement. Vous ne pouvez pas utiliser différents projets pour différents services au sein d'une même application.

Quelles sont les méthodes d'authentification compatibles ?

L'agent Google AI Studio configure Google Sign-In lorsque vous demandez à configurer Authentication ou un écran de connexion. Voici comment ajouter d'autres méthodes de connexion à votre application :

1. Dans la console Firebase, accédez à la page Sécurité > Authentification > Méthode de connexion, puis configurez les méthodes de connexion souhaitées.

2. De retour dans Google AI Studio, demandez à l'agent Google AI Studio de vous aider à mettre à jour votre codebase avec la nouvelle méthode de connexion.

Puis-je créer une application mobile (comme Android ou iOS) avec Google AI Studio ?

L'agent Google AI Studio permet de créer des applications Web et des applications Android. L'intégration Firebase permet d'ajouter Cloud Firestore et Authentication aux applications Web et Android. Elle est également compatible avec Firebase AI Logic et Firebase App Check pour les applications Android.

La création d'applications iOS n'est pas possible dans Google AI Studio. Toutefois, comme toutes les applications Web, celles créées par Google AI Studio sont accessibles en tant qu'applications Web mobiles depuis les navigateurs installés sur les appareils mobiles (y compris iOS).

Pour en savoir plus sur la création d'applications Android, consultez la documentation Google AI Studio.

Pourquoi l'intégration Firebase AI Logic et App Check n'est-elle utilisée que pour les applications Android et pas pour les applications Web ?

Les applications Android sont distribuées sous forme de binaires côté client (APK). Si une application Android appelait directement l'API Gemini à l'aide d'une clé API standard, n'importe qui pourrait décompiler l'APK, extraire la clé et effectuer des requêtes non autorisées. Pour éviter cela, les applications Android créées dans Google AI Studio utilisent Firebase AI Logic avec Firebase App Check pour vérifier que les requêtes proviennent d'une instance authentique de votre application.

En revanche, les applications Web créées dans Google AI Studio exécutent les requêtes de l'API Gemini à partir d'un environnement d'exécution sécurisé côté serveur (hébergé sur Cloud Run une fois déployé) à l'aide du SDK Google Gen AI. Étant donné que la clé API reste sur le serveur et n'est jamais exposée au navigateur client, les éléments Firebase AI Logic et App Check côté client ne sont pas requis pour les applications Web structurées de cette manière.

Qu'est-ce que le fichier firebase-blueprint.json ?

Il s'agit d'un fichier intermédiaire utilisé par l'agent Google AI Studio pour comprendre la base de code de votre application. Ne modifiez pas ce fichier manuellement, car cela pourrait amener l'agent à générer du code incorrect ou des Security Rules non sécurisés.

Que dois-je faire si je reçois un message d'erreur "Quota dépassé" ?

Si vous atteignez une limite de quota Cloud Firestore, cela signifie que votre application a atteint son plafond d'utilisation quotidienne pour votre groupe de quotas partagés de base de données Cloud Firestore. Pour résoudre ce problème, vous disposez de deux options :

• Option 1 : Attendre : les quotas sont réinitialisés tous les jours vers minuit, heure du Pacifique.
• Option 2 : Mise à niveau : passez au forfait Blaze avec paiement à l'usage.
  • Si l'agent Google AI Studio a configuré Cloud Firestore pour vous, vous devez ensuite utiliser le bouton Mettre à niveau la base de données décrit dans Ajouter la facturation pour obtenir plus de quota Cloud Firestore afin de faire passer votre base de données à un état payant normal. Si vous configurez Cloud Firestore manuellement, vous n'avez pas besoin d'utiliser le bouton Mettre à niveau la base de données.

Que faire si je reçois le message d'erreur "Autorisations manquantes ou insuffisantes" ?

Cette erreur se produit lorsque votre application tente de lire ou d'écrire des données dans votre base de données Cloud Firestore, mais que la requête est rejetée par vos Security Rules. Cela indique que les Security Rules n'autorisent pas l'opération tentée en fonction de l'état d'authentification ou du chemin d'accès aux données actuels. Cliquez sur le bouton Corriger l'erreur pour demander à l'agent Google AI Studio de tenter de corriger le Security Rules.

Qu'advient-il de mon backend Firebase lorsque je supprime mon application Google AI Studio ?

La suppression de votre application dans Google AI Studio ne supprime pas automatiquement le projet Firebase, la base de données Cloud Firestore ou les configurations Firebase Authentication associés.

Si vous avez ajouté un backend Firebase, vous devez accéder manuellement à la console Firebase et supprimer le projet ou nettoyer les ressources individuelles (telles que l'instance de base de données Cloud Firestore et les fournisseurs Authentication) pour vous assurer que toutes les données et configurations sont supprimées.

L'agent Google AI Studio peut-il supprimer ou modifier des données dans ma base de données Cloud Firestore ?

L'agent Google AI Studio est conçu pour vous aider à provisionner les ressources de backend nécessaires, et à générer du code et des Security Rules. Bien que l'agent lui-même ne puisse pas supprimer, modifier ni manipuler directement les entrées de données dans votre base de données Cloud Firestore, il peut écrire du code dans votre application conçu pour effectuer ces actions. Pour effectuer des tâches de gestion des données, comme la suppression d'entrées, accédez à la page Bases de données et stockage > Firestore dans la console Firebase.

Je fais partie d'une organisation qui utilise Google Cloud. Puis-je connecter mon application Google AI Studio à un projet existant dans l'environnement Google Cloud de mon organisation ?

Oui. Assurez-vous que votre projet Firebase est placé dans le dossier de votre organisation Google Cloud, puis associez votre projet à l'aide de l'une des méthodes suivantes :

• Lors de l'activation : lorsque vous activez l'intégration Firebase pour la première fois dans Google AI Studio, sélectionnez votre projet existant dans la fiche qui s'affiche. Cliquez sur l'icône Paramètres settings, puis sélectionnez votre projet.

• Pendant l'itération : si vous avez déjà activé Firebase ou si vous souhaitez changer de projet ultérieurement, vous pouvez demander à l'agent d'utiliser votre projet existant avec une requête telle que :

    Add Firestore to this app using project PROJECT_ID.
  

Pourquoi ne puis-je pas trouver certains documents dans la console Firebase ?

Lorsque l'agent AI Studio enregistre des données dans un chemin d'accès imbriqué (comme /users/user1/messages/msg1) sans créer au préalable le document parent (user1), il crée ce que l'on appelle un document parent inexistant. Ces documents ne s'affichent pas dans la console Firebase, ce qui peut rendre leur recherche difficile lorsque vous parcourez votre base de données Cloud Firestore. Bien que cela n'affecte pas le fonctionnement de votre application, vous pouvez souvent décrire le problème à l'agent AI Studio pour l'inciter à créer les documents parents manquants.

Pour en savoir plus, consultez Documents parents inexistants.

Puis-je choisir l'emplacement de ma base de données Cloud Firestore ?

Oui. Lorsque vous activez l'intégration Firebase dans Google AI Studio pour la première fois, vous pouvez sélectionner l'emplacement de votre base de données Cloud Firestore.

N'oubliez pas que l'emplacement que vous sélectionnez s'applique à toutes les bases de données Cloud Firestore que l'agent Google AI Studio crée dans ce projet Firebase. Une fois défini, cet emplacement ne peut plus être modifié pour ces bases de données.

Après avoir mis à niveau une base de données Cloud Firestore, puis-je la replacer dans le groupe de quotas partagés ?

Une fois qu'une base de données a été retirée du groupe de quotas partagés et convertie en instance payante standard, vous pouvez utiliser une commande curl pour la renvoyer dans le groupe de quotas partagés. Notez que toutes les bases de données du groupe de quotas partagés doivent être de la même édition et se trouver dans la même région.

• PROJECT_ID : ID du projet Firebase. Vous trouverez cet ID sur la page settings Paramètres > Général de la console Firebase.

• DATABASE_ID : ID de la base de données Cloud Firestore, qui correspond à l'ID de votre applet. Pour trouver cet ID de base de données dans Google AI Studio, accédez à Paramètres > Intégrations, puis cliquez sur la tuile Firebase Firestore et Auth.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID?updateMask=free_tier_limited" \
-d '{"free_tier_limited": true}'

Comment Google utilise-t-il mes données (par exemple, le code et les requêtes) dans Google AI Studio ?

Pour en savoir plus sur l'utilisation de vos données, consultez les Conditions d'utilisation supplémentaires de l'API Gemini.

J'ai reçu un e-mail de Google Cloud concernant une "clé API Google accessible publiquement pour votre projet Google Cloud". Que dois-je faire ?

Si vous avez reçu un e-mail de Google Cloud concernant une "clé API Google accessible publiquement pour votre projet Google Cloud" et que la clé API indiquée dans l'e-mail est votre clé API Firebase, assurez-vous qu'elle répond aux exigences suivantes pour pouvoir être incluse en toute sécurité dans votre code ou vos fichiers de configuration. Vous pouvez vérifier les éléments suivants sur la page API et services > Identifiants de la console Google Cloud.

• Il s'agit de la clé API que vous utilisez pour votre application Firebase et uniquement pour les services Firebase. Ces clés sont généralement appelées Browser key (auto created by Firebase), Android key (auto created by Firebase) ou iOS key (auto created by Firebase).
• Elle inclut toutes les API liées à Firebase requises dans la liste d'autorisation "Restrictions relatives aux API" de la clé.
• Elle ne comporte aucune autre API dans sa liste d'autorisation "Restrictions relatives aux API". En particulier, la liste ne doit pas comporter Generative Language API.

Assurez-vous également d'utiliser Firebase Security Rules et App Check comme recommandé pour les produits Firebase que vous utilisez.

Pour en savoir plus sur les clés API pour Firebase et consulter une liste de questions fréquentes, consultez En savoir plus sur l'utilisation et la gestion des clés API pour Firebase.