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

El modo de compilación en Google AI Studio puede configurar e integrar automáticamente Cloud Firestore y Firebase Authentication en apps web, lo que facilita la compilación de apps con almacenamiento de datos persistentes y flujos de acceso seguros. Con solo una instrucción y unos pocos clics, puedes permitir que el agente de Google AI Studio configure un proyecto de Firebase, conecte tu app a ese proyecto y genere todo el código de Cloud Firestore y Authentication directamente en tu app.

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, puedes ingresar la siguiente instrucción: Build a shared to-do list app using Firebase as a backend.

Nota: Para obtener mejores resultados, pídele explícitamente al agente que use Firebase como backend de tu app.
Habilita la integración de Firebase: Cuando el agente te lo solicite, habilita Firebase, selecciona una ubicación para tu proyecto y acepta las Condiciones de Firebase. Luego, el agente conecta automáticamente tu app a tu proyecto de Firebase y genera el código Cloud Firestore y Authentication necesario para tu app, incluidos un archivo /src/lib/firebase.ts y un archivo firestore.rules.
Implementa la app: Cuando esté todo listo, usa la opción Compartir > Publicar para implementar tu app web en Cloud Run.

Importante: Antes de compartir o implementar tu app, siempre revisa el Firebase Security Rules generado por IA.

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. Todas 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	Quota
Datos almacenados	1 GiB en total
Salida de red	10 GiB por mes
Unidades de escritura	40,000 operaciones de escritura por día
Unidades de lectura	50,000 operaciones de lectura 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 Firebase console 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 actualizas tu plan de precios. Para habilitar el escalamiento 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 Firebase console.
- 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 Firebase console.
```
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}'
```

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

El agente de Google AI Studio genera automáticamente Firebase Security Rules en función de la lógica de tu app. Estas Security Rules están diseñadas 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 de forma manual tus Security Rules directamente en Firebase console, el agente de Google AI Studio no conocerá los cambios y se reemplazarán durante las iteraciones posteriores de la app. Te recomendamos que uses el agente Google AI Studio para ajustar tus 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 Acceso 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 Firebase console. Para acceder a tus proyectos asociados con Google AI Studio, sigue estos pasos:

Navega a Firebase console 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.

¿Cómo se selecciona mi proyecto de Google Cloud o Firebase?

Cuando usas la función Add Firebase backend, el agente de Google AI Studio selecciona automáticamente un proyecto de Firebase para usar en los servicios de backend de tu app (Cloud Firestore y Firebase Authentication).

Si, en cambio, quieres usar un proyecto específico, puedes indicarle al agente que lo haga con una instrucción como la siguiente:

Use project PROJECT_ID for the Firebase backend.

Si más adelante decides publicar tu app en Cloud Run, es importante que sigas usando este mismo proyecto. Si eliges un proyecto diferente, se producirán errores, ya que no coincidirá con el proyecto que se usa para tu backend.

¿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 Firebase console y pídele ayuda al agente de Google AI Studio para actualizar tu base de código.

¿Puedo crear una app para dispositivos móviles (como para Android o iOS) con Google AI Studio?

Actualmente, el agente de Google AI Studio solo puede crear apps web. Obtén más información sobre lo que se admite en la documentación del agente de Google AI Studio.

Sin embargo, ten en cuenta que, al igual que todas las apps web, se puede acceder a las apps creadas por Google AI Studio como apps web para dispositivos móviles desde los navegadores instalados en dispositivos móviles.

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

Este es un archivo intermedio que usa el agente de 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 seguras.

¿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 tus Security Rules rechazan la solicitud. Indica que las Security Rules no permiten la operación que se intentó 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 las 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 Firebase console 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 los parámetros de configuración.

¿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 Firebase console.

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 Firebase console?

Cuando el agente de AI Studio guarda datos en una ruta anidada (como /users/user1/messages/msg1) sin crear primero el documento superior (user1), crea lo que se conoce como un documento superior inexistente. Estos documentos no se muestran en Firebase console, 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 superiores faltantes.

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

¿Cómo usa Google mis datos (por ejemplo, instrucciones y código) 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.

Recibí un correo electrónico de Google Cloud sobre una "clave de las APIs de Google a la que se puede acceder públicamente para tu proyecto de Google Cloud". ¿Qué debo hacer?

Si recibiste un correo electrónico de Google Cloud sobre una "clave de las APIs de Google a la que se puede acceder públicamente para tu proyecto de Google Cloud" y la clave de API que aparece en el correo electrónico es tu clave de API de Firebase, asegúrate de que la clave de API cumpla con los siguientes requisitos para que sea seguro incluirla en tus archivos de código o configuración. Puedes verificar lo siguiente en el panel APIs y servicios > Credenciales de la consola de Google Cloud.

Es la clave de API que usas para tu app de Firebase y solo para los servicios de Firebase. Por lo general, estas claves se denominan Browser key (auto created by Firebase) o Android key (auto created by Firebase) o iOS key (auto created by Firebase).
Tiene todas las APIs relacionadas con Firebase requeridas incluidas en la lista de entidades permitidas de "restricciones de API" de la clave.
No tiene ninguna otra API en su lista de entidades permitidas de "restricciones de APIs". En particular, la lista no debe tener Generative Language API.

Además, asegúrate de usar Firebase Security Rules y App Check según lo recomendado para los productos de Firebase que uses.

Puedes obtener detalles sobre las claves de API para Firebase y encontrar una lista de preguntas frecuentes en Obtén más información para usar y administrar las claves de API para Firebase.

Importante: La clave de API que usas para las llamadas a Gemini Developer API en tu app nunca debe incluirse en tu código ni en los archivos de configuración. Debe protegerse de la exposición pública. En la consola de Google Cloud, se llamará Gemini API Key o Gemini Developer API key (auto created by Firebase), y se restringirá a Generative Language API.