Comienza a usar Firebase con un proyecto de Google Cloud existente

Un proyecto de Firebase es un proyecto de Google Cloud que tiene habilitados algunos parámetros de configuración y servicios específicos de Firebase adicionales. Esto se conoce comúnmente como "agregar Firebase" a un proyecto de Google Cloud. En esta página, se describe cómo "agregar Firebase", junto con algunas preguntas frecuentes (FAQ).

Cuando agregas Firebase a un proyecto de Google Cloud, Firebase habilita automáticamente varias APIs y crea cuentas de servicio para simplificar el uso de todos los servicios y todas las interfaces de Firebase. Firebase también agrega una etiqueta firebase:enabled a tu proyecto en la página Etiquetas de la consola de Google Cloud. Obtén más detalles sobre qué sucede cuando "agregas Firebase".

Relación entre un proyecto de Firebase y un proyecto de Google Cloud

Ya que un proyecto de Firebase es un proyecto de Google Cloud, ocurre lo siguiente:

• Puedes acceder al proyecto y también interactuar con él en Firebase console, así como en la consola de Google Cloud y en la Consola de APIs de Google.

• Puedes interactuar con el proyecto con Firebase CLI, gcloud CLI y cualquier recurso de Terraform de Google.

• Puedes usar productos y APIs tanto de Firebase como de Google Cloud en un proyecto.

• Los roles y permisos de IAM para el proyecto se comparten entre Firebase y Google Cloud. Cualquier acceso que un miembro del proyecto (es decir, un principal) tenga a tu proyecto de Google Cloud también se aplicará a tu proyecto de Firebase (y viceversa).

• La facturación del proyecto se comparte entre Firebase y Google Cloud. Si la facturación está habilitada en tu proyecto de Google Cloud, tu proyecto de Firebase formará parte del plan de precios Blaze de pago por uso de Firebase.

• Los identificadores únicos del proyecto (como el número del proyecto y el ID del proyecto) se comparten entre Firebase y Google Cloud.

• Cualquier jerarquía de recursos aplicada a tu proyecto de Google Cloud (por ejemplo, organización, carpetas, etc.) también se aplicará a tu proyecto de Firebase.

• Si se borra el proyecto, se borra de Firebase y Google Cloud.

• Si borras o modificas un recurso o datos dentro del proyecto, estos cambios se aplican a Firebase y Google Cloud.

Cómo agregar Firebase a un proyecto de Google Cloud existente

Puedes "agregar Firebase" a un proyecto de Google Cloud existente con cualquiera de las siguientes opciones. Asegúrate de tener los permisos necesarios para agregar Firebase al proyecto de Google Cloud.

Ten en cuenta que, una vez que "agregas Firebase" a un proyecto de Google Cloud existente, no se puede deshacer (es decir, no puedes "quitar Firebase" por completo del proyecto de Google Cloud). Obtén más información en estas Preguntas frecuentes.

Nota: Para acceder a todas las funciones de Firebase y usarlas en un proyecto de Google Cloud, debes aceptar las Condiciones del Servicio de Firebase. Obtén más información sobre el requisito de las Condiciones de Firebase en estas Preguntas frecuentes.

Consola de Firebase

1. Ir a Firebase console.

2. Accede con la misma Cuenta de Google que te permite acceder al proyecto de Google Cloud existente.

3. Haz clic en Create a project (Crear un proyecto).

4. En la parte inferior de la página, haz clic en el vínculo para la pregunta ¿Ya tienes un proyecto de Google Cloud?

5. En el campo de texto, comienza a ingresar el ID del proyecto existente y, luego, selecciónalo en la lista que aparece.

6. Haz clic en Abrir proyecto.

7. Si se te solicita, acepta las Condiciones de Firebase.

8. Sigue las instrucciones en pantalla para "agregar Firebase" y configurar un proyecto de Firebase.

   Ten en cuenta que habilitar Google Analytics es opcional.

Firebase CLI

1. Si aún no lo hiciste, Instala la CLI de Firebase.

2. Accede con la misma Cuenta de Google que te permite acceder al proyecto de Google Cloud existente.

3. Ejecuta el siguiente comando:

   firebase projects:addfirebase

4. Cuando se te solicite, selecciona el proyecto Google Cloud existente de la lista que se muestra.

5. Si aún no aceptaste las Condiciones de Firebase, abre un proyecto de Firebase en Firebase console para aceptarlas. Obtén más información sobre el requisito de las Condiciones de Firebase en estas Preguntas frecuentes.

API de REST

1. Habilita la API de Firebase Management en el proyecto de Google Cloud existente.

2. Genera tu token de acceso a la API.

3. Para habilitar los servicios de Firebase para el proyecto, llama a projects.addFirebase.

   Ten en cuenta que necesitarás el nombre del recurso de tu proyecto para realizar esta llamada.

4. Si aún no aceptaste las Condiciones de Firebase, abre un proyecto de Firebase en Firebase console para aceptarlas. Obtén más información sobre el requisito de las Condiciones de Firebase en estas Preguntas frecuentes.

Para obtener instrucciones detalladas, consulta Agrega servicios de Firebase a tu proyecto en la guía de Firebase: "Configura y administra un proyecto de Firebase con la API de REST de Management". Asegúrate de seguir todas las instrucciones de la sección Antes de comenzar de esa guía.

Terraform

1. Habilita la API de Firebase Management (firebase.googleapis.com) en el proyecto de Google Cloud existente.

2. Habilita los servicios de Firebase para el proyecto con el recurso google_firebase_project.

3. Si aún no aceptaste las Condiciones de Firebase, abre un proyecto de Firebase en Firebase console para aceptarlas. Obtén más información sobre el requisito de las Condiciones de Firebase en estas Preguntas frecuentes.

Para obtener información detallada sobre el uso de Firebase y Terraform, consulta Comienza a usar Terraform y Firebase.

Preguntas frecuentes y solución de problemas

¿Es necesario aceptar las Condiciones del Servicio de Firebase para comenzar a usar Firebase?

Para acceder a todas las funciones de Firebase y usarlas en un proyecto de Google Cloud, debes aceptar las Condiciones del Servicio de Firebase.

Solo debes aceptar las Condiciones de Firebase una vez para tu Cuenta de Google, sin importar a cuántos proyectos tengas acceso. Cuando aceptas las condiciones, solo las aceptas para tu Cuenta de Google. La aceptación no se realiza a nivel del proyecto para todos los miembros.

Para aceptar las Condiciones de Firebase, abre el proyecto de Firebase en Firebase console y sigue las instrucciones en pantalla.

Importante: Si firmaste una variante física del Acuerdo Estándar de Google Cloud para el uso de servicios específicos de Firebase con la misma Cuenta de Google Cloud Platform, las Condiciones de Firebase no se aplican al uso de esos servicios de Firebase, y las condiciones físicas rigen el uso de esos servicios de Firebase.

¿Qué permisos se requieren para "agregar Firebase"?

Para "agregar Firebase" a un proyecto de Google Cloud existente, un miembro del proyecto (es decir, un principal) debe tener los siguientes permisos de IAM:

• firebase.projects.update
• resourcemanager.projects.get
• serviceusage.services.enable
• serviceusage.services.get

Los roles de IAM de editor y propietario contienen estos permisos de forma predeterminada.

¿Es suficiente agregar la etiqueta firebase:enabled para agregar Firebase?

Todos los proyectos de Firebase tienen una etiqueta firebase:enabled en la página Etiquetas de la consola de Google Cloud.

Sin embargo, agregar manualmente la etiqueta firebase:enabled a tu lista de etiquetas de proyecto NO habilita los parámetros de configuración y los servicios específicos de Firebase para tu proyecto de Google Cloud. Para hacerlo, debes agregar Firebase con Firebase console (o, en casos de uso avanzados, con Firebase CLI, la API de REST para Firebase Management o Terraform).

¿Qué sucede cuando "agregas Firebase" a un proyecto de Google Cloud existente?

Un proyecto de Firebase es un proyecto de Google Cloud que tiene habilitados algunos parámetros de configuración y servicios específicos de Firebase adicionales. Por lo tanto, cuando "agregas Firebase" a un proyecto de Google Cloud existente, Firebase realiza las siguientes acciones para simplificar el uso de todos los servicios y las interfaces de Firebase:

• Agrega la etiqueta firebase:enabled en la página Etiquetas de la consola de Google Cloud.

• Crea una clave de API de "Navegador" y la restringe automáticamente a las APIs relacionadas con Firebase.

• Crea las siguientes cuentas de servicio:

  • [e-mail]
  • [e-mail]
  • firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com

• Habilita las siguientes APIs:

  • API de App Engine Admin
  • API de Cloud Pub/Sub
  • API de Cloud Resource Manager
  • API de Cloud Runtime Configuration
  • API de Cloud Testing
  • API de Firebase Cloud Messaging
  • API de Firebase Dynamic Links
  • API de Firebase Hosting
  • API de Firebase Installations
  • API de Firebase Management
  • API de Firebase Remote Config
  • API en tiempo real para Firebase Remote Config
  • API de reglas de Firebase
  • API de Identity Toolkit
  • API de Token Service

¿Puedo "quitar Firebase" de un proyecto?

Una vez que "agregas Firebase" a un proyecto de Google Cloud existente, no se puede deshacer (es decir, no puedes "quitar Firebase" por completo del proyecto de Google Cloud).

El proceso de "agregar Firebase" habilita las APIs y los servicios de backend que se pueden usar para otras funciones de Google Cloud. Inhabilitar todos estos servicios habilitados podría causar consecuencias inesperadas y no deseadas debido a las dependencias.

Sin embargo, si lo deseas, puedes inhabilitar manualmente todas las APIs y borrar la etiqueta, la clave de API y las cuentas de servicio que se habilitaron y crearon automáticamente cuando "agregaste Firebase".

Advertencia: Si decides inhabilitar y borrar de forma manual lo que sucedió durante el proceso de "agregar Firebase", hazlo con extrema precaución. Debes asegurarte de que tu proyecto de Google Cloud y las apps asociadas con él no usen nada relacionado con lo que inhabilitas y borras. De lo contrario, tu proyecto o app podría dejar de funcionar o comportarse de formas inesperadas.

¿Se puede bloquear la opción para "agregar Firebase" para un proyecto de Google Cloud existente?

Sí, puedes bloquear la posibilidad de "agregar Firebase" a un proyecto de Google Cloud existente. Estas son algunas opciones:

• Bloquea la habilitación de la API de firebase.googleapis.com con una restricción "Restringir los servicios y las APIs de Google Cloud permitidos".

• Limita los miembros del proyecto (es decir, los principales) que tienen el permiso de IAM firebase.projects.update, que es necesario para "agregar Firebase". Puedes usar una política de denegación de IAM para hacerlo de forma eficiente.

Próximos pasos

• Consulta los siguientes recursos para obtener más información sobre los proyectos de Firebase:

  • Comprende los proyectos de Firebase: Se proporcionan descripciones generales breves de varios conceptos importantes sobre los proyectos de Firebase, incluida su relación con Google Cloud y la jerarquía básica de un proyecto y sus apps y recursos.

  • Prácticas recomendadas generales para configurar proyectos de Firebase: Se proporcionan prácticas recomendadas generales de alto nivel para configurar proyectos de Firebase y registrar tus apps en un proyecto para que tengas un flujo de trabajo de desarrollo claro que use entornos distintos.

• Para comenzar a usar Firebase en tus apps web y para dispositivos móviles, regístralas con tu proyecto de Firebase y conéctalas a Firebase: iOS+ | Android | Web | Flutter | Unity | C++.