Agrega Cloud Firestore y Authentication a tu app de Google AI Studio

Google AI Studio se integra directamente con Cloud Firestore y Firebase Authentication, lo que te permite compilar aplicaciones con datos persistentes y flujos de acceso seguros. Cuando usas la función "Agregar backend de Firebase" en Google AI Studio, el agente genera el código requerido y conecta tu app a un proyecto de Firebase.

Descripción general: Agrega un backend a tu app de Google AI Studio

Describe tu idea: Crea una app nueva en Google AI Studio y describe una función que requiera una base de datos o autenticación (por ejemplo, "Crea una lista de tareas compartida").

Nota: Para obtener mejores resultados, usa Gemini 3 Flash.
Habilita la integración de Firebase: Selecciona el chip Add Firebase backend. El agente genera el código necesario, incluidos un archivo /src/lib/firebase.ts y un archivo firestore.rules, y, luego, conecta tu app a Cloud Firestore y Firebase Authentication.
Implementar: Cuando esté todo listo, usa la opción Compartir > Publicar para implementar tu app en Cloud Run.

Comprende la cuota compartida de Cloud Firestore

Todas las bases de datos de Cloud Firestore que aprovisiona el agente en Google AI Studio se colocan en el mismo "grupo" de bases de datos en tu proyecto de Firebase. Todos comparten las siguientes características:

Cuota compartida: Todas las bases de datos del grupo comparten una cuota de uso (consulta los detalles a continuación).
No se requiere una cuenta de Cloud Billing: Puedes compilar y probar tu app sin agregar facturación. Consulta los detalles a continuación para agregar la facturación de forma opcional.
Restablecimientos diarios: Si alcanzas un límite de cuota diario (por ejemplo, 50,000 lecturas por día), el servicio se pausará para todas las bases de datos del grupo y se reanudará al día siguiente alrededor de la medianoche, hora del Pacífico.

Las bases de datos de Cloud Firestore en el grupo de cuota compartida tienen los siguientes límites:

Métrica	Cuota
Datos almacenados	1 GiB en total
Salida de red	10 GiB por mes
Unidades de escritura	40,000 escrituras por día
Unidades de lectura	50,000 lecturas por día
Unidades de actualización en tiempo real	50,000 actualizaciones por día

(Opcional) Agrega la facturación para obtener más cuota de Cloud Firestore

Si tu app gana popularidad y necesitas superar los límites sin costo de Cloud Firestore, puedes actualizar tu proyecto al plan de precios Blaze de pago por uso.

Agrega la facturación (si aún no lo hiciste): Navega a la consola de Firebase y vincula una cuenta de facturación a tu proyecto.
Actualiza la base de datos: De forma predeterminada, las bases de datos de Cloud Firestore creadas por el agente de Google AI Studio siguen usando la cuota compartida incluso después de que actualices tu plan de precios. Para habilitar el ajuste de escala pagado completo para una base de datos específica, debes moverla manualmente fuera del grupo con un comando curl.
- PROJECT_ID : ID del proyecto de Firebase. Puedes encontrarlo en la Configuración del proyecto de la consola de Firebase.
- DATABASE_ID : ID de la base de datos de Cloud Firestore, que coincidirá con el ID de tu applet. Puedes encontrar este ID de la base de datos en la columna Nombre de la página de bases de datos de Cloud Firestore en la consola de Firebase.
```
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=limited_free_tier" \
-d '{"limited_free_tier": false}'
```

Importante: Vincular una cuenta de Cloud Billing no quita automáticamente los límites de cuota compartidos.

Falla compartida: Si se agota la cuota compartida, todas las bases de datos del grupo devolverán errores. No tienen acceso a la cuenta de facturación vinculada.
Uso adicional: Para habilitar el uso adicional de una base de datos específica, debes quitarla del grupo de cuotas compartidas con el comando curl proporcionado. Esto convierte esa instancia en una base de datos pagada normal en la que todo el uso se cobra a tarifas de Cloud Firestore.
Transiciona una base de datos: Una vez que una base de datos se haya quitado del grupo de cuotas compartidas y se haya convertido en una instancia pagada normal, puedes invertir el valor booleano en el comando curl para devolverla al grupo de cuotas compartidas. Ten en cuenta que todas las bases de datos dentro del grupo de cuotas compartido deben ser de la misma edición y estar ubicadas en la misma región.

Generación de Security Rules

Google AI Studio genera automáticamente Firebase Security Rules en función de la lógica de tu app. Estos Security Rules están diseñados para ser de "rechazo predeterminado", lo que significa que los usuarios finales de tu app solo pueden acceder a los datos que les pertenecen.

Ten en cuenta que, si ajustas manualmente tu Security Rules directamente en la consola de Firebase, el agente de Google AI Studio no conocerá los cambios y se sobrescribirán durante las iteraciones posteriores de la app. Te recomendamos que uses el agente Google AI Studio para ajustar tu Firebase Security Rules y asegurarte de que los cambios se conserven y se alineen con la lógica de tu app.

Usa un proyecto existente

También puedes pedirle al agente de Google AI Studio que aprovisione Cloud Firestore en un proyecto de Google Cloud existente que sea de tu propiedad. Indícale al agente que use tu proyecto existente con una instrucción como la siguiente:

Add Firestore to this app using project PROJECT_ID.

Se aprovisionará una nueva base de datos de Cloud Firestore en ese proyecto con la cuota compartida.
Se configurará Firebase Authentication con Acceder con Google.
Se le otorgará acceso a una cuenta de servicio a tu base de datos de Cloud Firestore. Para permitir el acceso de administrador desde Google AI Studio, se le otorgará permiso a una nueva cuenta de servicio llamada ais-sandbox@PROJECT_ID.iam.gservice.com para acceder a tu base de datos de Cloud Firestore. Esta cuenta solo está asociada con tus apps de Google AI Studio.
Limitaciones: Si el proyecto de Firebase ya tiene una base de datos de Cloud Firestore, el agente no podrá agregar otra. Deberás crear un proyecto nuevo y vacío para usarlo.

Usa Firebase console

Puedes ver los datos y la configuración de tu app en la consola de Firebase. Para acceder a tus proyectos asociados con Google AI Studio, sigue estos pasos:

Navega a la consola de Firebase y selecciona el proyecto etiquetado como AI Studio.
En el panel de navegación de la izquierda, haz clic en Compilación > Cloud Firestore Database para ver y editar tus datos en Cloud Firestore, o bien haz clic en Compilación > Authentication para configurar tus parámetros y datos de Authentication.

Solución de problemas y preguntas frecuentes

Encuentra respuestas a preguntas frecuentes y aprende a resolver problemas cuando integras Firebase en tu app de Google AI Studio.

¿Qué métodos de autenticación se admiten?

El agente de Google AI Studio configura el acceso con Google cuando usas la función Add Firebase backend. Para configurar métodos adicionales, habilítalos en la consola de Firebase y pídele ayuda al agente de Google AI Studio para actualizar tu base de código.

¿Qué es el archivo `firebase-blueprint.json`?

Este es un archivo intermedio que usa el agente Google AI Studio para comprender la base de código de tu app. No modifiques este archivo de forma manual, ya que podría hacer que el agente genere código incorrecto o Security Rules no segura.

¿Qué debo hacer si recibo un error de "Cuota excedida"?

Alcanzar un límite de cuota de Cloud Firestore significa que tu app alcanzó su límite de uso diario para tu grupo de cuota compartida de la base de datos de Cloud Firestore. Existen dos formas de resolver este problema:

Opción 1: Espera: Las cuotas se restablecen todos los días a medianoche, hora del Pacífico.
Opción 2: Actualiza: Actualiza al plan de precios Blaze de pago por uso.
- Si el agente de Google AI Studio configuró Cloud Firestore por ti, debes usar el comando curl que se describe en Agrega facturación para obtener más cuota de Cloud Firestore y cambiar tu base de datos a un estado pagado normal. Si configuras Cloud Firestore de forma manual, no es necesario ejecutar el comando curl.

¿Qué debo hacer si recibo un error de "Permisos faltantes o insuficientes"?

Este error ocurre cuando tu app intenta leer o escribir datos en tu base de datos de Cloud Firestore, pero tu Security Rules rechaza la solicitud. Indica que los Security Rules no permiten la operación intentada según el estado de autenticación o la ruta de acceso a los datos actuales. Haz clic en el botón Corregir error para indicarle al agente de Google AI Studio que intente corregir el Security Rules.

¿Qué sucede con mi backend de Firebase cuando borro mi app de Google AI Studio?

Si borras tu aplicación en Google AI Studio, no se borrarán automáticamente el proyecto de Firebase conectado, la base de datos de Cloud Firestore ni las configuraciones de Firebase Authentication.

Si agregaste un backend de Firebase, debes ir manualmente a la consola de Firebase y borrar el proyecto o limpiar los recursos individuales (como la instancia de la base de datos de Cloud Firestore y los proveedores de Authentication) para asegurarte de que se quiten todos los datos y las configuraciones.

¿El agente de Google AI Studio puede borrar o editar datos en mi base de datos de Cloud Firestore?

El agente de Google AI Studio está diseñado para ayudar a aprovisionar los recursos de backend necesarios y generar código y Security Rules. Si bien el agente no puede borrar, editar ni manipular directamente las entradas de datos en tu base de datos de Cloud Firestore, puede escribir código en tu applet diseñado para realizar estas acciones. Para realizar tareas de administración de datos, como borrar entradas, navega a la página de la base de datos de Cloud Firestore en la consola de Firebase.

Pertenezco a una organización que usa Google Cloud. ¿Puedo conectar mi app de Google AI Studio a un proyecto existente dentro del entorno de Google Cloud de mi organización?

Asegúrate de que tu proyecto de Firebase se encuentre dentro de una carpeta de organización de Google Cloud en particular:

Crea tu proyecto de Firebase de forma manual con anticipación.
Cuando configures tu backend de Firebase en Google AI Studio, indícale al agente que use tu proyecto existente:
```
Add Firestore to this app using project PROJECT_ID.
```

¿Por qué no puedo encontrar ciertos documentos en la consola de Firebase?

Cuando el agente de AI Studio guarda datos en una ruta anidada (como /users/user1/messages/msg1) sin crear primero el documento principal (user1), crea lo que se conoce como un documento principal inexistente. Estos documentos no se muestran en la consola de Firebase, lo que puede dificultar su búsqueda cuando exploras tu base de datos de Cloud Firestore. Si bien esto no afecta el funcionamiento de tu app, a menudo puedes describir el problema al agente de AI Studio para solicitarle que cree los documentos principales faltantes.

Para obtener más detalles, consulta Documentos principales inexistentes.

¿Cómo se elige la ubicación de mi base de datos de Cloud Firestore?

Actualmente, la ubicación de tu base de datos de Cloud Firestore se selecciona automáticamente según tu ubicación y no se puede cambiar ni especificar de forma manual. Si quieres tener la capacidad de elegir una ubicación específica, ve a Configuración > Enviar comentarios en Google AI Studio.

¿Cómo usa Google mis datos (por ejemplo, código y mensajes) en Google AI Studio?

Consulta las Condiciones del Servicio Adicionales de la API de Gemini para obtener detalles sobre cómo se usan tus datos.