- 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.
- 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.
- Web Push. Los dispositivos Android pueden suscribirse a su sitio web o PWA sin un Service Account de FCM. Consulte Configuración de push web.
- Dispositivos Huawei sin servicios de Google Play. Consulte Autorización de Huawei.
- Dispositivos Amazon (Fire OS). Consulte Generación de clave API de Amazon.
Requisitos
- Una aplicación Android que se ejecute en dispositivos con servicios de Google Play, incluidas compilaciones de Google Play, instaladas manualmente (sideload) e internas
- Una cuenta de OneSignal
- Una cuenta de Firebase (gratis)
Crear una clave privada de Service Account de Firebase \
Crear o abrir su proyecto de Firebase

Página de Proyectos dentro de Firebase
Habilitar Firebase Cloud Messaging API V1

Pestaña Cloud Messaging en la configuración del proyecto de Firebase
- 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.

Firebase Cloud Messaging API habilitada en Google Cloud Console
Generar una nueva clave privada

Sección de Service Accounts dentro de Firebase

Generar la clave privada para el Service Account.
.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.Abrir la configuración de Android
Cargar su clave privada de Service Account
.json que guardó en la sección anterior.
Pantalla de configuración de FCM
Guardar y continuar
Agregar su archivo de configuración de Firebase \
Su aplicación necesita un archivogoogle-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?
Descargar google-services.json
applicationId de su aplicación y luego descargue google-services.json.Agregarlo a su aplicación
Aplicar el plugin de Gradle de Google Services
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:Verificar que el archivo surtió efecto \
Compile su aplicación y luego confirme que el plugin generó los recursos de cadena de Firebase: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 suapplicationId. 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 laFirebaseApp 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:
- 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
-32y 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
-6y las Subscriptions existentes se marcan como no válidas.
google-services.json tiene este aspecto:
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 agregargoogle-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/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.
Abrir la página IAM
Encontrar su Service Account
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.Agregar los roles que falten
Guardar
¿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 asupport@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 asupport@onesignal.com con su App ID.
¿Por qué no veo un Sender ID en OneSignal? \
Si su clave de servidor de Firebase se ve comoAIz..., 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 campofcm_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.