Instala una extensión de Firebase

Puedes instalar (y administrar) cualquiera de las extensiones oficiales de Firebase con Firebase console o Firebase CLI (una interfaz de línea de comandos).

Asegúrate de revisar las diferencias entre las acciones que se admiten en Firebase CLI y en Firebase console.


Para instalar o administrar extensiones, debes tener asignado uno de estos roles: Propietario o Editor, o bien Administrador de Firebase.

Si quieres instalar una extensión, tu proyecto debe tener el plan Blaze (prepago). Aunque la instalación es sin cargo, es posible que se te cobre por el uso de los servicios de Firebase o los servicios de Cloud como Cloud Secret Manager si tu uso sobrepasa el nivel gratuito de los servicios.

Antes de comenzar

Si aún no lo has hecho, agrega Firebase a tu proyecto y cámbialo al plan Blaze (pago por uso).

Paso 1: Revisa los detalles de la extensión

Este paso es opcional, pero muy recomendable.

Antes de instalar una extensión de Firebase, te recomendamos revisar la información detallada sobre la extensión, incluido lo siguiente:

  • El funcionamiento de la extensión, las tareas previas a la instalación y los detalles de la extensión
  • Información general de identificación y descripción
  • Si se necesita una cuenta de facturación para las tareas de la extensión
  • Los servicios de Google (API) y las funciones de acceso necesarios para el funcionamiento
  • Los recursos creados para la extensión (como las funciones)
  • Descripciones de los parámetros configurables por los usuarios

Para ver la información detallada de una extensión, debes hacer lo siguiente:

  1. Explora las extensiones oficiales de Firebase en el Centro de extensiones.

  2. Haz clic en la tarjeta de una extensión para realizar lo siguiente:

Paso 2: Instala una extensión

Durante el proceso de instalación, se te solicitará que revises las especificaciones básicas de la extensión (como las API habilitadas, los recursos creados, el acceso otorgado, etc.). Se te notificará sobre los requisitos de facturación y también se te solicitará que especifiques los valores para los parámetros configurables de la extensión.

  1. Explora las extensiones oficiales de Firebase en el Centro de extensiones.

  2. Haz clic en la tarjeta de una extensión y, luego, revisa la información detallada que aparece allí; esta puede incluir instrucciones de uso específicas y tareas previas a la instalación.

  3. Haz clic en Instalar y sigue las instrucciones en pantalla para instalar la extensión.

Paso 3: Completa la configuración posterior a la instalación

Algunas extensiones tienen pasos opcionales u obligatorios que debes completar antes de usarlas. Encontrarás estas instrucciones en la página de detalles posteriores a la instalación de la extensión en el panel Extensiones de Firebase console (el vínculo específico al panel se muestra en la terminal después de la instalación).

También puedes encontrar estas instrucciones en el archivo POSTINSTALL.md incluido en el directorio del código fuente de la extensión.

Crea recursos de Firebase

Si configuraste la extensión para que use recursos de Firebase (colecciones de Cloud Firestore, rutas de acceso de Realtime Database, buckets de Cloud Storage) que aún no existen, créalos antes de usar la extensión.

Crea controladores de eventos de Eventarc

Algunas extensiones se publican en Eventarc cuando ocurren eventos importantes durante la ejecución. Si una extensión publica eventos y habilitaste los eventos durante la instalación, puedes escribir funciones que reaccionen a ellos con tu propia lógica personalizada. Por ejemplo, esto puede ser útil para notificar a los usuarios cuando se completan tareas de larga duración o para procesar posteriormente el resultado de una función de extensión.

Consulta la documentación de la extensión para obtener una lista de los eventos que publica (si los hay). Por ejemplo, consulta los tipos de eventos de la extensión Run Payments with Stripe.

Luego, consulta Activadores de eventos personalizados y obtén información para escribir controladores de eventos de Eventarc.

Instala varias instancias de extensiones

Puedes instalar la misma extensión más de una vez en el mismo proyecto. Cada instancia instalada puede tener su propia configuración personalizada y sus propios recursos de extensión. Identificas cada instancia instalada y haces referencia a ellas mediante el ID de instancia, que es único dentro de tu proyecto. Se te pedirá que confirmes o edites el ID de instancia de cada instancia adicional de la extensión que instales.

Próximos pasos