Saltar al contenido principal
Para enviar notificaciones push a dispositivos Android con servicios de Google Play, necesita dos cosas del mismo proyecto de Firebase:
  1. Una clave privada de Service Account de FCM, cargada en OneSignal. Autoriza a los servidores de OneSignal a enviar a su proyecto de Firebase. Obligatoria.
  2. Un archivo google-services.json, agregado a su aplicación. Es la configuración de cliente de Firebase que se incluye dentro de su aplicación. Recomendado para todas las integraciones nuevas y obligatorio para el registro con Firebase Installation ID.
Estas instrucciones no se aplican a:

Requisitos


Crear una clave privada de Service Account de Firebase \

1

Crear o abrir su proyecto de Firebase

Vaya a su consola de Firebase y cree o seleccione un proyecto.
Consola de Firebase mostrando la lista de proyectos disponibles

Página de Proyectos dentro de Firebase

2

Habilitar Firebase Cloud Messaging API V1

En la configuración de su proyecto de Firebase, seleccione la pestaña Cloud Messaging.
Configuración del proyecto de Firebase mostrando la pestaña Cloud Messaging con el estado de Firebase Cloud Messaging API (V1) como Enabled

Pestaña Cloud Messaging en la configuración del proyecto de Firebase

Verifique el estado de Firebase Cloud Messaging API (V1):
  • Enabled (marca de verificación verde) significa que Google acepta solicitudes de envío de Cloud Messaging para este proyecto.
  • Disabled significa que Google rechaza esas solicitudes, por lo que las notificaciones push de Android no se entregan. Para habilitarla, haga clic en el menú de 3 puntos > Manage API in Google Cloud Console, luego haga clic en Enable y espere hasta que el estado muestre API Enabled con una marca de verificación verde.
Página de Firebase Cloud Messaging API en Google Cloud Console mostrando el estado API Enabled con una marca de verificación verde

Firebase Cloud Messaging API habilitada en Google Cloud Console

Habilitar la API no otorga ningún rol al Service Account. Si otra persona es propietaria del proyecto de Firebase o de la cuenta de Google, primero verifique los permisos de su Service Account.
3

Generar una nueva clave privada

De vuelta en Project settings, seleccione la pestaña Service accounts y haga clic en Generate new private key.
Pestaña Service accounts en la configuración del proyecto de Firebase mostrando el botón Generate new private key

Sección de Service Accounts dentro de Firebase

Confirme haciendo clic en Generate key en la ventana emergente.
Diálogo de confirmación de Firebase para generar una nueva clave privada para el Service Account

Generar la clave privada para el Service Account.

La clave privada descargada contiene credenciales sensibles. No la comparta ni la registre en el control de versiones.
Guarde el archivo .json en una ubicación segura. Lo cargará en OneSignal en la siguiente sección.

Cargar la clave privada de Service Account en OneSignal

Cargue la clave privada para que los servidores de OneSignal puedan enviar notificaciones push a través de su proyecto de Firebase.
1

Abrir la configuración de Android

Vaya a Settings > Push & In-App y siga los pasos hasta llegar a la configuración de Google Android (FCM).
2

Cargar su clave privada de Service Account

Haga clic en Select file y elija la clave privada .json que guardó en la sección anterior.
Pantalla de configuración Google Android (FCM) de OneSignal con el campo de carga de archivo Service Account JSON y el botón Select file

Pantalla de configuración de FCM

3

Guardar y continuar

Haga clic en Save & Continue. OneSignal valida la clave privada y lo lleva a la selección del SDK.
Si el panel muestra Invalid request, es probable que al Service Account le falte un rol obligatorio. Consulte ¿Cómo verifico los permisos de mi Service Account?

Agregar su archivo de configuración de Firebase \

Su aplicación necesita un archivo google-services.json del mismo proyecto de Firebase que el Service Account anterior. No cargue este archivo en OneSignal. Pertenece al código fuente de su aplicación e indica a su aplicación con qué proyecto de Firebase registrarse. En el SDK de Android de OneSignal 5.11.0 y versiones posteriores, el SDK se registra a través de su proyecto de Firebase cuando su google-services.json coincide con el Sender ID en OneSignal. De lo contrario, el SDK usa el proyecto de Firebase compartido de OneSignal. Consulte ¿Qué sucede si omito google-services.json?
¿Actualiza una aplicación existente? La entrega sigue usando el mismo proyecto de Firebase y el mismo Service Account, pero:
  • Cada dispositivo obtiene un nuevo valor de token de push la próxima vez que abre la aplicación actualizada. Su Subscription se conserva y el token anterior funciona hasta entonces.
  • Las métricas de FCM de su consola de Firebase empiezan a incluir los registros de OneSignal.
  • Sus llamadas de token de Firebase ahora afectan a OneSignal. Llamar a FirebaseMessaging.getInstance().deleteToken() (al cerrar sesión, por ejemplo) también elimina el registro de OneSignal hasta que el SDK vuelva a registrarse. Con el registro con Firebase Installation ID, la llamada equivalente es unregister().
Planifique agregar el archivo en algún momento. Sin él, su aplicación sigue usando tokens de registro de FCM heredados, que Firebase ha declarado obsoletos.
1

Descargar google-services.json

En su consola de Firebase, abra el proyecto que usó para la clave privada de Service Account. Vaya a Project settings > General y desplácese hasta Your apps. Si su aplicación Android no aparece, haga clic en Add app.Confirme que el Android package name coincide con el applicationId de su aplicación y luego descargue google-services.json.
2

Agregarlo a su aplicación

Su aplicación nunca lee el archivo en tiempo de ejecución. Un paso de compilación lo convierte en recursos de Android y, sin ese paso, el archivo no hace nada. Busque su plataforma a continuación y siga su guía de configuración.
En versiones del SDK anteriores a las indicadas arriba, es seguro agregar el archivo, pero no tiene ningún efecto para OneSignal. Push sigue registrándose a través del proyecto de Firebase compartido de OneSignal hasta que actualice.
3

Aplicar el plugin de Gradle de Google Services

Este paso es solo para Android nativo, React Native y Flutter. Las demás plataformas gestionan el plugin como se describe en la tabla anterior.El plugin se resuelve desde el repositorio Maven de Google. Confirme que google() aparece en pluginManagement en settings.gradle o settings.gradle.kts; de lo contrario, la compilación falla con Plugin [id: 'com.google.gms.google-services'] was not found:
settings.gradle.kts
Agregue el plugin a su archivo Gradle de nivel de proyecto:
Luego aplíquelo en su archivo Gradle de nivel de aplicación:
Si su proyecto usa un catálogo de versiones de Gradle, declare la versión allí en lugar de en el archivo de nivel de proyecto. El paso de nivel de aplicación anterior no cambia.
Sincronice Gradle.El rango lo mantiene en el plugin 4.x más reciente. Para fijar una versión específica, consulte la documentación de Google.

Verificar que el archivo surtió efecto \

Compile su aplicación y luego confirme que el plugin generó los recursos de cadena de Firebase:
Si aparecen google_app_id y project_id, el archivo surtió efecto. Una compilación correcta por sí sola no lo demuestra.
  • No aparece ninguno de los dos valores: el plugin no está aplicado. Agregar el archivo sin el plugin no produce ningún error.
  • File google-services.json is missing: el plugin está aplicado, pero el archivo no está donde su cadena de herramientas lo espera. Revise la tabla anterior.
  • No matching client found for package name: el paquete registrado en Firebase no coincide con su applicationId. Corríjalo en la consola de Firebase y vuelva a descargar el archivo.
  • El archivo proviene de un proyecto de Firebase distinto al de su Service Account: consulte Hacer coincidir sus proyectos de Firebase.

Configurar Firebase sin google-services.json \

Inicialice la FirebaseApp predeterminada en código si no puede usar el plugin de Gradle de Google Services, o si carga Firebase solo después del consentimiento del usuario. Use valores del mismo proyecto de Firebase que la clave privada de Service Account que cargó en OneSignal:
Inicialice Firebase antes de que se inicialice OneSignal. No se requiere un bucket de almacenamiento para push. Si la inicialización no ha terminado cuando OneSignal se registra para push:
  • En la ruta de token heredada, el SDK se registra a través del proyecto de Firebase compartido de OneSignal durante esa sesión y usa su proyecto en una sesión posterior.
  • Con el registro con Firebase Installation ID activado, el registro falla con el estado -32 y se reintenta en una sesión posterior.

Hacer coincidir sus proyectos de Firebase \

Su aplicación debe registrarse con el mismo proyecto de Firebase que la clave privada de Service Account que cargó en OneSignal. Cuando los proyectos son diferentes:
  • En la ruta de token heredada, el SDK de OneSignal se registra a través del proyecto de Firebase compartido de OneSignal y registra una advertencia.
  • Con el registro con Firebase Installation ID activado, el registro falla con el estado -6 y las Subscriptions existentes se marcan como no válidas.
Compare cualquiera de los valores siguientes. El Project ID y el Project Number de un proyecto de Firebase están emparejados de forma permanente, así que si uno coincide, ambos coinciden. Su google-services.json tiene este aspecto:
google-services.json

Preguntas frecuentes

¿Qué sucede si omito google-services.json? \

Las notificaciones push siguen funcionando hoy. El SDK de OneSignal se registra a través del proyecto de Firebase compartido de OneSignal, usando tokens de registro de FCM. Google ha declarado obsoletos los tokens de registro de FCM en favor de los Firebase Installation IDs. El proyecto compartido no puede registrarse con Firebase Installation IDs, así que agregar google-services.json ahora prepara su aplicación para ese cambio si Google llega a exigir Firebase Installation IDs. Sin el archivo, tampoco puede activar el registro con Firebase Installation ID.

¿Cómo verifico los permisos de mi Service Account? \

Los roles del Service Account se otorgan en la página IAM de Google Cloud Console, no en la consola de Firebase ni en la página Service Accounts. El Service Account cuya clave privada carga en OneSignal necesita estos dos roles: Roles más amplios como Firebase Admin (roles/firebase.admin), Editor u Owner también incluyen ambos permisos y cumplen con el requisito. Para Service Accounts dedicados solo a OneSignal, prefiera el par estrecho mencionado arriba para limitar el impacto si la clave privada llega a exponerse. Si el panel de OneSignal muestra Invalid request después de cargar su clave privada de Service Account, la causa más común son los roles faltantes.
1

Abrir la página IAM

En Google Cloud Console, configure el selector de proyectos en el proyecto de Firebase, no en la organización. En la navegación izquierda, abra IAM & Admin y haga clic en IAM.La página es una tabla con las columnas Principal, Name y Role. No use Service Accounts > Permissions. Esa página muestra quién puede usar la cuenta, no qué roles tiene la cuenta en el proyecto.
2

Encontrar su Service Account

Busque la fila cuyo correo del principal coincida con el campo client_email de la clave privada que cargó. Tiene un formato como firebase-adminsdk-xxxxx@YOUR_PROJECT_ID.iam.gserviceaccount.com. Pegue ese correo en el cuadro de filtro si la tabla es larga.
3

Agregar los roles que falten

En esa fila, haga clic en el lápiz (Edit principal). En el panel Edit permissions, haga clic en Add another role y agregue Firebase Cloud Messaging API Admin y Firebase Viewer si aún no están asignados. Omita este paso si la cuenta ya tiene Firebase Admin, Editor u Owner.
4

Guardar

Haga clic en Save. Los nuevos roles pueden tardar aproximadamente un minuto en aplicarse.

¿Por qué veo “This configuration is for a different Firebase Project”?

Este error ocurre cuando la clave privada cargada pertenece a un proyecto de Firebase diferente (un Sender ID diferente). Solución: Use la clave privada del proyecto de Firebase original. Si no está disponible, contacte a support@onesignal.com con su App ID. Cambiar de proyectos restablece los tokens de push. Sus usuarios deben volver a abrir la aplicación para recibir push nuevamente. También ocurre lo contrario: la clave cargada es correcta, pero la aplicación incluye un google-services.json de un proyecto de Firebase diferente. Consulte Hacer coincidir sus proyectos de Firebase.

¿Puedo cambiar mi Sender ID? \

Sí, pero cambiarlo invalida los tokens de dispositivo existentes, porque los tokens están vinculados al Sender ID original. Los usuarios dejan de recibir notificaciones push hasta que vuelven a abrir la aplicación y obtienen un nuevo token. Si necesita ayuda, contacte a support@onesignal.com con su App ID.

¿Por qué no veo un Sender ID en OneSignal? \

Si su clave de servidor de Firebase se ve como AIz..., probablemente esté usando una configuración obsoleta de Google Cloud Messaging (GCM). Agregue Firebase a su proyecto existente de Google Cloud para conservar su Sender ID y luego cargue una clave privada de Service Account. Crear un nuevo proyecto de Firebase le da un nuevo Sender ID, lo que invalida los tokens de push existentes. Consulte ¿Puedo cambiar mi Sender ID?

¿Necesito actualizar mi código al cambiar a FCM V1?

No se requieren cambios en la aplicación ni en el SDK. Esta es una actualización solo del panel.

¿Las API heredadas de FCM siguen siendo compatibles? \

No. Las API heredadas de FCM de Google están completamente obsoletas y ya no entregan notificaciones. Si su aplicación todavía las usa, cargue una clave privada de Service Account como se describe arriba para pasar a FCM V1.

¿Cómo puedo verificar qué aplicaciones aún usan la API heredada?

Llame a la API View an app para cada aplicación y verifique el campo fcm_v1_service_account_json en la respuesta:
  • Presente y no vacío: la aplicación está en FCM V1.
  • Faltante o vacío: la aplicación no está configurada para FCM V1. Si la aplicación envía push de Android, aún está en la API heredada y debe migrarse.
Para listar primero sus aplicaciones y sus App IDs, use la API View apps.

¿Qué es Firebase Cloud Messaging y por qué OneSignal necesita una clave privada de Service Account? \

Firebase Cloud Messaging (FCM) es el servicio de Google para entregar notificaciones push a dispositivos Android. Un Service Account es una identidad de Google que OneSignal usa para autenticarse en su proyecto de Firebase, y su clave privada es un archivo JSON que prueba la identidad. Cargar la clave privada autoriza a OneSignal a enviar push a través de Firebase en su nombre. Para más detalles, consulte la documentación de Service Account de Google.

Páginas relacionadas

Configuración del SDK móvil

Instale e inicialice el SDK de OneSignal en su aplicación Android.

Registro con Firebase Installation ID

Compruebe si el registro con FID está habilitado en su aplicación y habilítelo o deshabilítelo.

Configuración de push de Huawei

Autorice a OneSignal a enviar push a dispositivos Huawei sin servicios de Google Play.

Configuración de push de Amazon

Genere una clave API de Amazon para enviar push a dispositivos Fire OS.

Configuración de push web

Configure notificaciones push para sitios web.