Saltar al contenido principal
Para enviar notificaciones push a dispositivos Android a través de Google Play Store, OneSignal requiere credenciales de Firebase Cloud Messaging (FCM). Esta guía le explica cómo generar el archivo JSON de Service Account requerido y cargarlo en la configuración de su aplicación de OneSignal. Para antecedentes técnicos, consulte la documentación de Service Account de Google.
Esta guía es para desarrolladores que integran OneSignal con una aplicación móvil de Android distribuida a través de Google Play Store.

​
Requisitos

​
Configuración

​
1. Crear o abrir su proyecto de Firebase

Vaya a la consola de Firebase.
  • Si aún no tiene un proyecto, haga clic en Add project y complete la configuración.
  • Si ya tiene un proyecto, selecciónelo.

Página de proyectos dentro de Firebase

​
2. Habilitar Firebase Cloud Messaging API v1

1

Ir a Configuración del proyecto

En Firebase, haga clic en el ícono de engranaje junto a Project Overview > Project settings.

Submenú del ícono de engranaje de Firebase, mostrando Configuración del proyecto

2

Ir a Cloud Messaging

Vaya a la pestaña Cloud Messaging.Si Firebase Cloud Messaging API (V1) está deshabilitada, haga clic en el menú de 3 puntos > Open in Cloud Console.

Firebase Cloud Messaging API (V1) está deshabilitada en esta imagen. Asegúrese de que esté habilitada para su proyecto.

En Google Cloud Console, haga clic en Enable. Espere unos minutos para que el cambio se refleje en Firebase.

Habilitar Firebase Cloud Messaging API v1.

​
3. Generar un archivo JSON de Service Account

1

Volver a Configuración del proyecto > Service Accounts

En la parte inferior, haga clic en Generate new private key.

Sección de Service Accounts dentro de Firebase

2

Confirmar y generar clave

Confirme haciendo clic en Generate key en la ventana emergente.

🔒 Este archivo contiene credenciales confidenciales. No lo comparta ni lo registre en el control de versiones.

3

Guardar el archivo

Guarde el archivo .json en una ubicación segura. Lo necesitará en breve.
Permisos requeridos de Service Account:
  • cloudmessaging.messages.create
  • firebase.projects.get
Estos están incluidos por defecto. Si está usando un Service Account personalizado, asegúrese de que tenga:
  • roles/firebasemessaging.admin
  • roles/firebase.viewer

​
4. Cargar sus credenciales a OneSignal

1

Ir a la configuración de la plataforma Android

En su panel de OneSignal, vaya a: Settings > Push & In-App > Push Platforms > Google Android (FCM).Haga clic en Activate.

Pantalla de plataformas dentro de la configuración de la aplicación de OneSignal

2

Cargar sus credenciales

Cargue el archivo .json en Service Account JSON haciendo clic en Choose file.

Pantalla de configuración de FCM

Si se le solicita, seleccione Firebase Cloud Messaging API (V1) del menú desplegable.Para verificar que está usando el proyecto de Firebase correcto, coincida el Sender ID en Firebase (Cloud Messaging > Sender ID) con el que se muestra en su configuración de OneSignal.
3

Guardar y continuar

4

Elegir su SDK

Seleccione el SDK que está usando y haga clic en Save & Continue.

Pantalla de selección de SDK

5

Agregar el App ID de OneSignal a su código

Continúe siguiendo la Configuración del SDK móvil y agregue este App ID de OneSignal a su código.

Pantalla de instalación y prueba de configuración de Android

Ha conectado exitosamente su aplicación de OneSignal a Firebase Cloud Messaging (V1).A continuación, complete la Configuración del SDK móvil o vaya a Configuración de push móvil para instrucciones específicas de la plataforma.

​
FAQ

​
Error: “Esta configuración es para un proyecto de Firebase diferente…”

Este error ocurre cuando el archivo JSON cargado pertenece a un proyecto de Firebase diferente (es decir, un Sender ID diferente). Solución: Use el archivo JSON del proyecto de Firebase original. Si no está disponible, contacte a support@onesignal.com con su App ID. Cambiar de proyecto restablece los tokens de push: sus usuarios deben volver a abrir la aplicación para recibir push nuevamente.

​
¿Puedo cambiar mi Sender ID?

No. El Sender ID se bloquea una vez que su aplicación supera los 100 usuarios de Android para evitar la invalidación accidental de tokens de push. Si es necesario, contacte a support@onesignal.com con su App ID para obtener ayuda.

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

No se requieren cambios en la aplicación o el SDK; esta es una actualización solo del panel.

​
¿Cuál es la fecha límite para cambiar a FCM v1?

Google comenzó a deprecar las APIs heredadas de FCM en julio de 2024. Se recomienda encarecidamente la migración. Consulte el anuncio de Google.

​
¿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). Cree un nuevo proyecto de Firebase y cargue un archivo JSON de Service Account.

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

Use la API Ver aplicaciones y busque:
  • "gcm_key" → usando Legacy, necesita actualización
  • "fcm_v1_service_account_json" → usando V1 ✅
  • Ninguno → la aplicación no usa push de Android