Ajouter Cloud Firestore et l'authentification à votre application Google AI Studio

Le mode "Créer" de Google AI Studio peut configurer et intégrer automatiquement Cloud Firestore et Firebase Authentication dans les applications Web. Vous pouvez ainsi créer plus facilement des applications avec un stockage de données persistant et des flux de connexion sécurisés. En une seule requête et quelques clics, vous autorisez l'agent Google AI Studio à configurer un projet Firebase , à associer votre application à ce projet et à générer tout le code Cloud Firestore et Authentication directement dans votre application.

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 ou une authentification. Par exemple, vous pouvez saisir la requête suivante : Build a shared to-do list app using Firebase as a backend.

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

   • Personnalisez le projet ou l'emplacement (facultatif) : cliquez sur l'icône Settings settings, puis sélectionnez un emplacement ou le Google Cloud projet que vous souhaitez utiliser.
   • Confirmez votre sélection : pour continuer, cliquez sur le bouton Enable Firebase (Activer Firebase).

   L'agent associe ensuite automatiquement votre application à votre projet Firebase et génère le code Cloud Firestore et Authentication nécessaire, y compris un /src/lib/firebase.ts fichier et un firestore.rules fichier.

3. Déployez : une fois que vous êtes prêt, utilisez l'option Share > Publish (Partager > Publier) pour déployer votre application Web sur Cloud Run. Votre application sera automatiquement déployée dans le même projet que celui que vous avez sélectionné lors de la configuration.

   Avant de partager ou de déployer votre application, veillez également à consulter les règles de sécurité Firebase générées par l'IA Firebase Security Rules.

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 ou une authentification (par exemple, Add a Firestore database to this app).
• Utilisez le menu des paramètres : accédez à Settings > Integrations (Paramètres > Intégrations), puis cliquez sur la tuile Firebase Firestore & Auth.

Les deux options lanceront le flux de configuration de l'intégration Firebase, ce qui vous permettra 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 à Settings > Integrations (Paramètres > Intégrations) et en cliquant sur la tuile Firebase Firestore & Auth.

Comprendre le quota partagé pour Cloud Firestore

Selon la date de création de votre application et l'éligibilité de votre compte, vos bases de données peuvent être hébergées dans un projet de niveau Starter Google Cloud ou dans un projet standard. Toutefois, dans les deux cas, toutes les Cloud Firestore bases de données provisionnées par l'agent Google AI Studio sont placées dans le même "Quota partagé d'IA" groupe de bases de données de votre projet. Elles partagent toutes 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 n'est 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 de manière facultative.
• Réinitialisations quotidiennes : si vous atteignez une limite de quota quotidienne (par exemple, 50 000 lectures/jour), le service sera mis en pause pour toutes les bases de données du groupe et reprendra le lendemain vers minuit, heure du Pacifique.

Cloud Firestore bases de données du groupe de quotas partagés partagent les limites suivantes :

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

Si votre application gagne en popularité et que vous devez dépasser les limites sans frais de Cloud Firestore, vous pouvez ajouter la facturation, ce qui mettra à 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. Dans ce cas, votre projet bénéficie déjà du forfait Blaze et vous pouvez passer directement à l'étape Mettre à niveau la base de données.

Étape 1. Ajouter 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 Projects.
2. Cliquez sur Set up billing (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. Vous pouvez également être invité à effectuer un prépaiement (qui 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 avoir ajouté 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 la mise à l'échelle payante complète pour une base de données spécifique, vous devez la mettre à niveau manuellement.

1. Accédez à la Firebase console 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 à Databases & Storage > Firestore (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 Upgrade database > Upgrade to pay-as-you-go (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 avec paiement à l'usage pour votre base de données devrait prendre effet en quelques minutes.

Génération Security Rules

L'Google AI Studio agent 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 vos Security Rules directement dans la Firebase console, l'agent Google AI Studio n'en sera pas informé et elles seront écrasées lors des itérations ultérieures de l'application. Nous vous recommandons d'utiliser l'agent Google AI Studio pour ajuster vos Firebase Security Rules afin de vous assurer que vos modifications sont conservées et alignées sur la logique de votre application.

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 Settings settings (Paramètres > Paramètres).
2. Sélectionnez votre projet, puis cliquez sur Enable Firebase (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 est provisionnée dans ce projet à l'aide du quota partagé.
• Firebase Authentication avec Google Sign-In sera configuré.
• Un compte de service se voit accorder l'accès à 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 Cloud Firestore base de données. Ce compte n'est associé qu'à vos Google AI Studio applications.
• Limites : si le projet Firebase comporte déjà une Cloud Firestore base de données, 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 Firebase console

Vous pouvez afficher 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 Firebase console 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 à Databases & Storage > Firestore (Bases de données et stockage > Firestore).
   • Pour afficher ou configurer les paramètres et les données Authentication, accédez à Security > Authentication (Sécurité > Authentification).

Dépannage et FAQ

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 Google AI Studio application.

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 :

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

Tenez bien compte des éléments suivants :

• L'emplacement de la base de données est permanent : 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 garantir une intégration fluide, 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 de la même application.

Quelles méthodes d'authentification sont 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 Security > Authentication > Sign-in method, 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 code 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 est compatible avec la création d'applications Web et d'applications Android.

Toutefois, notez que l'intégration Firebase (ajout de Cloud Firestore et Authentication) n'est actuellement compatible qu'avec les applications Web, et non avec les applications Android. Si vous créez une application Android, vous devez intégrer manuellement Firebase si vous avez besoin de ces services.

Pour en savoir plus sur les fonctionnalités compatibles, consultez la Google AI Studio documentation de l'agent.

Notez toutefois que, comme toutes les applications Web, les applications Web créées par Google AI Studio sont accessibles en tant qu'applications Web mobiles à partir des navigateurs installés sur les appareils mobiles.

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 le code de votre application. Ne modifiez pas ce fichier manuellement, car cela pourrait entraîner l'agent à générer un code incorrect ou non sécurisé Security Rules.

Que faire si je reçois une erreur "Quota exceeded" (Quota dépassé) ?

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

• Option 1 : Attendre : les quotas sont réinitialisés tous les jours vers minuit, heure du Pacifique.
• Option 2 : Mettre à 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 Upgrade database (Mettre à niveau la base de données) décrit dans Ajouter la facturation pour obtenir plus de quota Cloud Firestore afin de passer votre base de données à un état payant standard. Si vous avez configuré Cloud Firestore manuellement, il n'est pas nécessaire d'utiliser le bouton Upgrade database (Mettre à niveau la base de données).

Que faire si je reçois une erreur "Missing or insufficient permissions" (Autorisations manquantes ou insuffisantes) ?

Cette erreur se produit lorsque votre application tente de lire ou d'écrire des données dans votre Cloud Firestore base de données, mais que la requête est rejetée par votre 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 actuel. Cliquez sur le bouton Fix error (Corriger l'erreur) pour inviter l'agent Google AI Studio à tenter de corriger les 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 ni les configurations Firebase Authentication associés.

Si vous avez ajouté un backend Firebase, vous devez accéder manuellement à la Firebase console et supprimer le projet ou nettoyer les ressources individuelles (telles que l'instance de base de données Cloud Firestore et les fournisseursAuthentication) 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'Google AI Studio agent est conçu pour vous aider à provisionner les ressources de backend nécessaires et à générer du code et 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 Cloud Firestore base de données, il peut écrire du code dans votre application conçu pour effectuer ces actions. Pour effectuer des tâches de gestion des données, telles que la suppression d'entrées, accédez à la page Databases & Storage > Firestore dans la console Firebase.

J'appartiens à une organisation qui utilise Google Cloud. Puis-je associer 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 Google Cloud dossier de votre organisation, 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 Settings settings et 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 trouve-t-on pas certains documents dans la Firebase console ?

Lorsque l'agent AI Studio enregistre des données dans un chemin d'accès imbriqué (tel que /users/user1/messages/msg1) sans créer d'abord le document parent (user1), il crée ce que l'on appelle un document parent inexistant. Ces documents ne s'affichent pas dans la Firebase console, ce qui peut les rendre difficiles à trouver lorsque vous parcourez votre Cloud Firestore base de données. 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'inviter à créer les documents parents manquants.

Pour en savoir plus, consultez la section Documents parents inexistants.

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

Oui. Lorsque vous activez l'intégration Firebase pour la première fois dans Google AI Studio, 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 Cloud Firestore bases de données que l'Google AI Studio agent 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 remettre 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 une instance payante standard, vous pouvez utiliser une commande curl pour la remettre 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 dans les settings Settings > General page de la Firebase console.

• DATABASE_ID : ID de la base de données Cloud Firestore, qui correspondra à l'ID de votre applet. Vous trouverez cet ID de base de données dans Google AI Studio en accédant à Settings > Integrations et en cliquant sur la tuile Firebase Firestore & 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 mon 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 listée dans l'e-mail est votre clé API Firebase, assurez-vous que la clé API 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 points suivants sur la page APIs & Services > Credentials (API et services > Identifiants) de la Google Cloud console.

• 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) ou 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 d'API" de la clé.
• Elle ne comporte aucune autre API dans sa liste d'autorisation "Restrictions d'API" En particulier, la liste ne doit pas contenir 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 trouver une liste de questions fréquentes, consultez la page Utiliser et gérer les clés API pour Firebase.