Cette page fournit une aide au dépannage et répond aux questions fréquentes sur Cloud Messaging.
Quelle est la différence entre le compositeur de notifications et FCM ?
Firebase Cloud Messaging fournit un ensemble complet de fonctionnalités de messagerie via ses SDK clients et son protocole de serveur HTTP. FCM est le bon choix pour les déploiements avec des exigences de messagerie plus complexes.
Le compositeur de notifications est une solution de messagerie légère et sans serveur basée sur Firebase Cloud Messaging. Grâce à une console graphique conviviale et à des exigences de codage réduites, le compositeur de notifications permet aux utilisateurs d'envoyer des messages pour réengager et fidéliser les utilisateurs, favoriser la croissance des applications et soutenir les campagnes marketing.
| Fonctionnalités |
|
Composer de notifications |
Cloud Messaging |
| Cible |
Un appareil |
|
|
|
Clients abonnés à des thèmes (par exemple, la météo) |
|
|
|
Clients dans le segment d'utilisateurs prédéfini (application, version, langue) |
|
|
|
Clients appartenant à des audiences Analytics spécifiques |
|
|
|
Clients dans les groupes d'appareils |
|
|
|
En amont du client vers le serveur |
|
|
| Type de message |
Notifications jusqu'à 2 ko |
|
|
|
Messages de données jusqu'à 4 ko |
|
|
| Diffusion |
Immédiat |
|
|
|
Heure locale future de l'appareil client |
|
|
| Analytics |
Collecte d'analyses et d'analyses de l'entonnoir pour les notifications intégrées |
|
|
Dois-je utiliser d'autres services Firebase pour utiliser FCM ?
Vous pouvez utiliser Firebase Cloud Messaging comme composant autonome, sans utiliser d'autres services Firebase.
Pourquoi mes appareils ciblés ne semblent-ils pas recevoir de messages ?
Si vous pensez que les appareils n'ont pas reçu les messages, vérifiez d'abord les deux causes potentielles suivantes :
Gestion des messages au premier plan pour les messages de notification. Les applications clientes doivent ajouter une logique de gestion des messages pour gérer les messages de notification lorsque l'application est au premier plan sur l'appareil. Consultez les détails pour iOS et Android.
Restrictions de pare-feu réseau Si votre organisation dispose d'un pare-feu qui limite le trafic vers ou depuis Internet, vous devez le configurer pour autoriser la connectivité avec FCM afin que vos applications clientes Firebase Cloud Messaging puissent recevoir des messages. Voici les ports à ouvrir :
FCM utilise généralement le port 5228, mais il utilise parfois les ports 5229 et 5230.
FCM ne fournit pas d'adresses IP spécifiques. Vous devez donc autoriser votre pare-feu à accepter les connexions sortantes vers toutes les adresses IP figurant dans les blocs d'adresses IP recensés dans le numéro de système autonome 15169 de Google.
Pourquoi onMessageReceived n'est-il pas appelé dans mon application Android ?
Lorsque votre application est en arrière-plan, les messages de notification s'affichent dans la barre d'état système et onMessageReceived n'est pas appelé. Pour les messages de notification avec une charge utile de données, le message de notification s'affiche dans la barre d'état système. Les données incluses dans le message de notification peuvent être récupérées à partir de l'intent lancé lorsque l'utilisateur appuie sur la notification.
Pour en savoir plus, consultez Recevoir et gérer les messages.
Pourquoi l'erreur 404 s'affiche-t-elle lorsque j'envoie des messages à une instance d'application active restaurée à partir d'une sauvegarde ?
L'ID d'installation Firebase (FID) est l'identifiant d'une instance d'application. Par défaut, les données d'installation Firebase sont sauvegardées et restaurées. Ainsi, dans le cas de la restauration, l'instance d'application restaurée et l'instance d'application d'origine partagent le même FID. Étant donné que FCM ne stocke qu'un seul jeton par FID, si l'instance d'application d'origine et l'instance d'application restaurée sont utilisées, lorsque l'une des instances d'application s'enregistre auprès de FCM, le jeton de l'autre instance d'application est supprimé, ce qui entraîne des erreurs 404.
Nous recommandons aux développeurs d'effectuer les actions suivantes dans leur application :
- Excluez les données d'installation Firebase de la sauvegarde. Les données d'installation de Firebase sont stockées dans un fichier
PersistedInstallation....json. Le nom de fichier est une constante pour une application. Par exemple, <exclude domain="file" path="PersistedInstallation.W0R...GQ.json"
/>
Apple a annoncé l'abandon de l'ancien protocole binaire pour APNs. Dois-je faire quelque chose ?
Non. Firebase Cloud Messaging est passé au protocole APNs basé sur HTTP/2 en 2017.
Si vous utilisez FCM pour envoyer des notifications aux appareils iOS, aucune action n'est requise de votre part.
Quotas et limites FCM
Comment informer une large base de clients en deux minutes ?
Ce cas d'utilisation n'est pas compatible. Vous devez répartir votre trafic sur cinq minutes.
Mon application envoie des notifications d'événements aux utilisateurs. Ces messages doivent être envoyés immédiatement pour soutenir mon modèle économique. Puis-je obtenir plus de quota ?
Malheureusement, nous ne pouvons pas augmenter votre quota pour cette raison. Vous devez répartir votre trafic sur cinq minutes pour éviter les pics de trafic.
Mes messages concernent des événements planifiés. Comment envoyer tout le trafic au début de l'heure ?
Nous vous recommandons de commencer à envoyer les notifications au moins cinq minutes avant l'événement. Vous pouvez également envoyer des messages de données et implémenter l'équivalent du gestionnaire onMessageReceived de votre plate-forme pour planifier les notifications locales à l'avance.
Les erreurs 429 sont difficiles à gérer pour moi et mon entreprise. Puis-je bénéficier d'une exemption ou d'un quota plus élevé pour éviter les erreurs 429 ?
Nous comprenons que les limites de quota peuvent être difficiles à gérer, mais elles sont essentielles pour assurer la fiabilité du service. Nous ne pouvons donc pas accorder d'exemptions. Utilisez des nouvelles tentatives pour gérer correctement les erreurs 429.
Combien de temps faut-il pour que ma demande d'augmentation de quota soit traitée ?
Votre demande d'augmentation de quota dépend de votre utilisation de FCM. Dans tous les cas, vous devriez recevoir une réponse sous quelques jours ouvrés. Dans certains cas, il peut y avoir des échanges concernant votre utilisation de FCM et diverses circonstances, ce qui peut prolonger le processus. Si toutes les conditions sont remplies, la plupart des demandes seront traitées sous deux semaines.
Puis-je obtenir plus de quota pour un événement temporaire ?
Vous pouvez demander un quota supplémentaire pour un événement d'une durée maximale d'un mois.
Envoyez votre demande au moins un mois avant l'événement en précisant clairement les dates de début et de fin. FCM fera tout son possible pour y répondre. Si elles sont accordées, ces augmentations de quota seront annulées après la date de fin de l'événement.
Mon quota actuel est-il susceptible de changer ?
Bien que Google ne le fasse pas à la légère, les quotas peuvent être modifiés si nécessaire pour protéger l'intégrité du système. Dans la mesure du possible, Google vous informera à l'avance de ces modifications. Mettez à jour vos contacts pour le contrat-cadre de services cloud afin d'augmenter vos chances de recevoir des annonces de service.
Abandons d'anciennes API FCM
API côté serveur obsolètes en septembre 2026
Quelles API et fonctionnalités sont obsolètes et seront mises hors service ? Que dois-je faire si j'utilise ces API ?
Toutes les API serveur InstanceId et la fonctionnalité de groupe d'appareils sont obsolètes et seront mises hors service le 29 septembre 2027. Le tableau suivant fournit plus de détails sur les API/fonctionnalités obsolètes et sur l'action requise.
| Nom d'API
|
Point de terminaison de l'API
|
Utilisation prévue
|
Impact sur les clients
|
Action requise
|
| API InstanceId info
|
https://iid.googleapis.com/iid/info
|
Obtenir des informations liées à un InstanceId / jeton FCM
|
Les requêtes envoyées à cette API ne seront plus traitées après le 29 septembre 2027.
|
Pour les clients qui utilisent l'API pour la validation des jetons, utilisez l'API d'envoi FCM V1 et définissez validate_only sur "true".
Si vous utilisez l'API pour obtenir des informations sur les abonnements aux thèmes, migrez vers la nouvelle API d'abonnement aux thèmes.
|
| API d'abonnement aux thèmes InstanceId
|
https://iid.googleapis.com/iid/v1/…/rel/topics
https://iid.googleapis.com/iid/v1:batchAdd
https://iid.googleapis.com/iid/v1:batchRemove
|
Abonnement de jetons à un sujet via l'ancienne API d'abonnement aux sujets.
|
Les requêtes envoyées à ces API commenceront à échouer après le 29 septembre 2027.
|
Migrez vers la nouvelle API du serveur d'abonnement aux thèmes FCM pour l'abonnement et la désinscription aux thèmes.
|
| API d'importation par lot InstanceId
|
https://iid.googleapis.com/iid/v1:batchImport
|
Créer des jetons FCM pour iOS par lot côté serveur.
|
Les requêtes envoyées à cette API ne seront plus traitées après le 29 septembre 2027.
La création d'enregistrements FCM à partir de jetons APNs côté serveur ne sera pas prise en charge.
|
Vous pouvez utiliser le service APNs d'Apple pour envoyer des notifications à l'aide de jetons APNs.
Pour bénéficier des avantages supplémentaires offerts par FCM, intégrez votre application au SDK iOS FCM, qui créera des enregistrements FCM sur le client.
|
| API de gestion des groupes d'appareils
|
https://fcm.googleapis.com/fcm/notification
https://fcm.googleapis.com/gcm/notification
https://fcm.googleapis.com/iid/notification
https://fcm.googleapis.com/notification
|
Ajouter / supprimer/ récupérer des membres d'un groupe d'appareils
|
Les requêtes envoyées à cette API ne seront plus traitées après le 29 septembre 2027.
|
Consultez les conseils pour migrer depuis cette fonctionnalité.
Il sera toujours possible d'envoyer des messages à des enregistrements FCM individuels au lieu de jetons de groupe.
|
| Envoi à un groupe d'appareils
|
https://fcm.googleapis.com/v1/projects/…/messages:send
|
Envoi de messages à des groupes d'appareils à l'aide de notification_key de groupe.
|
Cette API continuera de fonctionner, mais elle ne prendra plus en charge les jetons de groupe d'appareils après le 29 septembre 2027.
|
Si j'utilise le SDK Admin Firebase pour gérer les abonnements aux thèmes, serai-je concerné par l'arrêt de ce service ? Que dois-je faire ?
Si vous utilisez des versions antérieures du SDK Admin Firebase pour gérer les abonnements aux thèmes, vous serez concerné par l'arrêt de la prise en charge.
Vous devrez mettre à niveau votre SDK Admin Firebase vers les versions suivantes :
| Plate-forme
|
Version du SDK Admin concernée
|
Version du SDK Admin vers laquelle effectuer la mise à niveau
|
| Node.js
|
<=14.4.0
|
>=14.5.0
|
| Python
|
<=7.6.0
|
>=7.7.0
|
| Java
|
<=9.10.0
|
Bientôt disponible
|
| Accéder
|
<=4.21.0
|
>=4.22.0
|
| .NET
|
<=3.6.0
|
Bientôt disponible
|
Vais-je constater une dégradation du service avant le 29 septembre 2027 ?
Non. Vous disposez de 12 mois pour migrer des API obsolètes vers des alternatives sans que le service soit dégradé. Nous vous recommandons vivement de planifier la migration dès que possible afin de ne pas être affecté par l'arrêt de l'ancienne version.
Vous devriez recevoir des erreurs lorsque vous appellerez des API obsolètes après le 29 septembre 2027.
Les nouveaux utilisateurs peuvent-ils intégrer les API/fonctionnalités obsolètes avant leur arrêt ?
Les nouveaux utilisateurs peuvent intégrer les API/fonctionnalités obsolètes avant le 1er janvier 2027.
Après le 1er janvier 2027, les nouveaux utilisateurs ne pourront plus utiliser les API obsolètes.
Les utilisateurs qui utilisent les API obsolètes pourront continuer à le faire jusqu'au 29 septembre 2027.