Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

Le mode Build (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

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. (Créer une application de liste de tâches partagée à l'aide de Firebase comme backend).

**Conseil** : Pour obtenir de meilleurs résultats, demandez explicitement à l'agent d'utiliser Firebase comme backend pour votre application.
Activez l'intégration Firebase : dans la fiche qui s'affiche, vous pouvez personnaliser votre configuration :
- Sélectionnez un emplacement (facultatif) : choisissez l'emplacement de votre base de données et de votre application à l'aide du menu déroulant.
- Sélectionnez un projet (facultatif) : cliquez sur l'icône Paramètres , sélectionnez le Google Cloud projet que vous souhaitez utiliser, puis cliquez sur Enregistrer.
- Confirmez votre sélection : pour continuer, cliquez sur le bouton 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 et un firestore.rules.

Important: Le projet et l'emplacement que vous sélectionnez pour votre première fonctionnalité intégrée (tels que Cloud Firestore et Authentication) s'appliqueront automatiquement à tous les autres services Firebase et Google Cloud (tels que Cloud Run) que vous ajouterez ultérieurement à votre application. Une fois définis, vous ne pourrez plus modifier l'emplacement de ces ressources configurées à l'aide de Google AI Studio.
Déployez : une fois que vous êtes prêt, utilisez l'option 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.

Important : Avant de partager ou de déployer votre application, examinez toujours les règles de sécurité Firebase générées par l'IA.Firebase Security Rules

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 de démarrage 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 :

Métrique	Quota
Données stockées	1 Gio au total
Sortie réseau	10 Gio par mois
Unités d'écriture	40 000 écritures par jour
Unités de lecture	50 000 lectures par jour
Unités de mises à jour en temps réel	50 000 mises à jour par jour

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

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 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.

Dans Google AI Studio, accédez à la page Projets.
Cliquez sur Configurer la facturation à côté du projet que vous souhaitez mettre à niveau.
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).

Important: La configuration de la facturation dans Google AI Studio crée ou met automatiquement à niveau le compte de facturation associé vers un compte de facturation payant. Cela signifie que toute l'utilisation du service est soumise à la tarification standard avec paiement à l'usage, y compris toute utilisation de Firebase et d'autres Google Cloud services (à l'exception des instances Cloud Firestore qui se trouvent toujours dans le groupe de quotas partagés).

Si vous créez un nouveau compte de facturation, vous pouvez toujours être éligible à des crédits de bienvenue d'essai sans frais à utiliser pour Firebase et d'autres Google Cloud services.
Si vous associez un compte de facturation existant, vous pouvez utiliser les crédits de bienvenue d'essai sans frais restants pour l'utilisation de Firebase et d'autres Google Cloud services. Sachez que si d'autres projets sont associés à ce compte de facturation, toute utilisation dans ces projets est désormais soumise à la tarification avec paiement à l'usage.

Notez que la configuration de la facturation directement dans Google AI Studio est disponible en version Preview publique.

É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 le scaling payant complet pour une base de données spécifique, vous devez la déplacer manuellement hors du groupe à l'aide d'une commande curl.

PROJECT_ID : ID du projet Firebase. Vous trouverez cet ID dans les Paramètres > Général 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 la console Firebase en accédant à la page Bases de données et stockage > Firestore, puis en regardant dans la colonne Nom.

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": false}'

Vérifier la mise à niveau de la base de données

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. Vous pouvez vérifier la modification à l'aide de l'une des options suivantes :

Testez votre application (recommandé) : le moyen le plus fiable de confirmer la mise à niveau consiste à utiliser votre application. Effectuez les Cloud Firestore opérations qui dépassaient auparavant les limites quotidiennes sans frais (par exemple, en dépassant les seuils de l'édition Cloud Firestore Enterprise de 50 000 unités de lecture ou 40 000 unités d'écriture). Ces opérations devraient maintenant réussir sans erreurs RESOURCE_EXHAUSTED.
Vérifiez l'état de la base de données via l'API : vous pouvez utiliser une requête curl GET pour récupérer les détails actuels de la base de données :
```
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID"
```
Inspectez la réponse JSON. La base de données est mise à niveau et n'est plus limitée si le champ freeTierLimited est absent de la réponse.

Remarque : La réponse JSON de la commande PATCH initiale ne reflète pas immédiatement la modification. Vous ne pouvez donc pas utiliser sa réponse pour confirmer la modification. À la place, émettez la requête GET pour la vérifier.

Comprendre freeTier et freeTierLimited: vous verrez probablement toujours voir "freeTier": true dans la réponse GET. Ce champ est distinct du paramètre freeTierLimited que vous avez modifié. "freeTier": true est lié à l'origine de la base de données et à la possibilité d'utiliser le niveau sans frais. Cela ne signifie pas que les limites quotidiennes sont toujours appliquées une fois que vous avez défini freeTierLimited sur false. La désactivation réussie des limites est indiquée par l'absence de freeTierLimited dans la réponse GET.

Si votre application rencontre toujours des erreurs de limite quotidienne après plusieurs minutes d'attente, et qu'une requête GET indique que le champ freeTierLimited est effectivement absent, assurez-vous que le compte de facturation de votre projet est en règle.

Important: L'association d'un compte Cloud Billing ne supprime pas automatiquement les limites de quota partagé.

Échec partagé : si le quota partagé est épuisé, toutes les bases de données du groupe renverront des erreurs. Elles n'ont pas accès au compte de facturation associé.
Utilisation supplémentaire : pour activer une utilisation supplémentaire pour une base de données spécifique, vous devez déplacer cette base de données hors du groupe de quotas partagés à l'aide de la commande curl fournie. Cette instance est alors convertie en une base de données payante standard où toute l'utilisation est facturée aux Cloud Firestore tarifs.
Migrer une base de données : une fois qu'une base de données a été déplacée hors du groupe de quotas partagés et convertie en une instance payante standard, vous pouvez inverser le booléen dans la commande curl pour la renvoyer au 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.

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 :

Dans la fiche qui s'affiche, cliquez sur l'icône Paramètres icon .
Sélectionnez votre projet, puis cliquez sur Enregistrer.

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 :

Accédez à la Firebase console et sélectionnez le projet libellé AI Studio.
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.

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 :

Sélectionnez un emplacement (facultatif) : choisissez l'emplacement de votre base de données et de votre application à l'aide du menu déroulant.
Sélectionnez un projet (facultatif) : cliquez sur l'icône Paramètres , sélectionnez le Google Cloud projet que vous souhaitez utiliser, puis cliquez sur Enregistrer.

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'Google AI Studio agent 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 :

Dans la console Firebase, accédez à la page Sécurité > Authentification > Méthode de connexion, puis configurez les méthodes de connexion souhaitées.
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 ?

Actuellement, l'agent Google AI Studio ne peut créer que des applications Web. Pour en savoir plus sur les éléments compatibles, consultez la Google AI Studio documentation de l'agent.

Notez toutefois que, comme toutes les applications Web, les applications 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 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 pouvez résoudre ce problème de deux manières :

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 la commande curl décrite dans Ajouter la facturation pour obtenir un quota Cloud Firestore plus important afin de faire passer votre base de données à un état payant standard. Si vous avez configuré Cloud Firestore manuellement, l'exécution de la commande curl n'est pas nécessaire.

Que faire si je reçois une erreur "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 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'agent Google AI Studio est conçu pour vous aider à provisionner les ressources de backend nécessaires , ainsi qu'à 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 Bases de données et stockage > Firestore de 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 dans Google AI Studio, sélectionnez votre projet existant dans la fiche qui s'affiche. Cliquez sur l'icône Paramètres , sélectionnez votre projet, puis cliquez sur Enregistrer.
Lors de 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 certains documents n'apparaissent-ils pas 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 d'abord créer 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 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 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.

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 au public 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 au public pour votre projet Google Cloud " et que la clé API indiqué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 dans le API et services > Identifiants panneau 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.

Important : La clé API que vous utilisez pour les appels à Gemini Developer API dans votre application ne doit jamais être incluse dans votre code ni dans vos fichiers de configuration. Elle doit être protégée contre l'exposition publique. Dans la console Google Cloud, elle sera appelée Gemini API Key ou Gemini Developer API key (auto created by Firebase), et elle sera limitée à l'API Generative Language API.