Passer au contenu principal
Pour envoyer des notifications push aux appareils Android via le Google Play Store, OneSignal nécessite des identifiants Firebase Cloud Messaging (FCM). Ce guide vous guide dans la génération du fichier JSON de compte de service requis et son téléchargement dans les paramètres de votre application OneSignal. Pour le contexte technique, consultez la documentation du compte de service de Google.
Ce guide est destiné aux développeurs intégrant OneSignal avec une application mobile Android distribuée via le Google Play Store.

​
Prérequis

​
Configuration

​
1. Créer ou ouvrir votre projet Firebase

Accédez à la console Firebase.
  • Si vous n’avez pas encore de projet, cliquez sur Ajouter un projet et complétez la configuration.
  • Si vous avez déjà un projet, sélectionnez-le.

Page des projets dans Firebase

​
2. Activer l’API Firebase Cloud Messaging v1

1

Accéder aux paramètres du projet

Dans Firebase, cliquez sur l’icône d’engrenage à côté de Aperçu du projet > Paramètres du projet.

Sous-menu de l'icône d'engrenage Firebase, affichant les paramètres du projet

2

Accéder à Cloud Messaging

Accédez à l’onglet Cloud Messaging.Si l’API Firebase Cloud Messaging (V1) est désactivée, cliquez sur le menu à 3 points > Ouvrir dans Cloud Console.

L'API Firebase Cloud Messaging (V1) est désactivée dans cette image. Assurez-vous qu'elle est activée pour votre projet.

Dans la console Google Cloud, cliquez sur Activer. Attendez quelques minutes que le changement se reflète dans Firebase.

Activer l'API Firebase Cloud Messaging v1.

​
3. Générer un fichier JSON de compte de service

1

Retourner à Paramètres du projet > Comptes de service

En bas, cliquez sur Générer une nouvelle clé privée.

Section Comptes de service dans Firebase

2

Confirmer et générer la clé

Confirmez en cliquant sur Générer la clé dans la fenêtre contextuelle.

🔒 Ce fichier contient des identifiants sensibles. Ne le partagez pas et ne le versionnez pas.

3

Enregistrer le fichier

Enregistrez le fichier .json dans un emplacement sécurisé. Vous en aurez besoin sous peu.
Autorisations requises pour le compte de service :
  • cloudmessaging.messages.create
  • firebase.projects.get
Celles-ci sont incluses par défaut. Si vous utilisez un compte de service personnalisé, assurez-vous qu’il dispose de :
  • roles/firebasemessaging.admin
  • roles/firebase.viewer

​
4. Télécharger vos identifiants vers OneSignal

1

Accéder aux paramètres de la plateforme Android

Dans votre tableau de bord OneSignal, accédez à : Paramètres > Push et In-App > Plateformes Push > Google Android (FCM).Cliquez sur Activer.

Écran des plateformes dans les paramètres de l'application OneSignal

2

Télécharger vos identifiants

Téléchargez le fichier .json sous JSON de compte de service en cliquant sur Choisir un fichier.

Écran de configuration FCM

Si demandé, sélectionnez API Firebase Cloud Messaging (V1) dans le menu déroulant.Pour vérifier que vous utilisez le bon projet Firebase, faites correspondre l’ID d’expéditeur dans Firebase (Cloud Messaging > ID d'expéditeur) avec celui affiché dans vos paramètres OneSignal.
3

Enregistrer et continuer

4

Choisir votre SDK

Sélectionnez le SDK que vous utilisez et cliquez sur Enregistrer et continuer.

Écran de sélection du SDK

5

Ajouter l'ID d'application OneSignal à votre code

Continuez à suivre la Configuration du SDK mobile et ajoutez cet ID d’application OneSignal à votre code.

Écran d'installation et de test de la configuration Android

Vous avez connecté avec succès votre application OneSignal à Firebase Cloud Messaging (V1).Ensuite, complétez la Configuration du SDK mobile ou accédez à Configuration du push mobile pour les instructions spécifiques à la plateforme.

​
FAQ

​
Erreur : “Cette configuration est pour un projet Firebase différent…”

Cette erreur se produit lorsque le fichier JSON téléchargé appartient à un projet Firebase différent (c’est-à-dire un ID d’expéditeur différent). Solution : Utilisez le fichier JSON du projet Firebase d’origine. S’il n’est pas disponible, contactez support@onesignal.com avec votre ID d’application. Le changement de projet réinitialise les jetons push—vos utilisateurs doivent rouvrir l’application pour recevoir à nouveau des notifications push.

​
Puis-je changer mon ID d’expéditeur ?

Non. L’ID d’expéditeur est verrouillé une fois que votre application dépasse 100 utilisateurs Android pour éviter l’invalidation accidentelle des jetons push. Si nécessaire, contactez support@onesignal.com avec votre ID d’application pour obtenir de l’aide.

​
Dois-je mettre à jour mon code lors du passage à FCM V1 ?

Aucune modification de l’application ou du SDK n’est requise—il s’agit d’une mise à jour uniquement du tableau de bord.

​
Quelle est la date limite pour passer à FCM v1 ?

Google a commencé à déprécier les API FCM héritées en juillet 2024. La migration est fortement recommandée. Voir l’annonce de Google.

​
Pourquoi ne vois-je pas d’ID d’expéditeur dans OneSignal ?

Si votre clé de serveur Firebase ressemble à AIz..., vous utilisez probablement une configuration Google Cloud Messaging (GCM) obsolète. Créez un nouveau projet Firebase et téléchargez un fichier JSON de compte de service.

​
Comment puis-je vérifier quelles applications utilisent encore l’API héritée ?

Utilisez l’API View apps et vérifiez :
  • "gcm_key" → utilise l’hérité, nécessite une mise à jour
  • "fcm_v1_service_account_json" → utilise V1 ✅
  • Ni l’un ni l’autre → l’application n’utilise pas le push Android