La messagerie par sujet FCM vous permet d'envoyer un message à plusieurs appareils qui ont accepté de recevoir des messages sur un sujet particulier. Vous rédigez des messages par sujet selon vos besoins, et FCM se charge de les acheminer et de les distribuer de manière fiable aux bons appareils.
Points essentiels concernant la messagerie par sujet :
- Elle est idéale pour les informations disponibles publiquement, comme les alertes météo.
- Les messages par sujet sont optimisés pour le débit plutôt que pour la latence. Pour une distribution rapide et sécurisée à des appareils individuels ou à de petits groupes, ciblez les messages sur les jetons d'enregistrement plutôt que sur les sujets.
Quotas et limites
La messagerie par sujet accepte un nombre illimité d'abonnements pour chaque sujet. Toutefois, FCM applique des limites dans les domaines suivants :
- Une instance d'application ne peut pas être abonnée à plus de 2 000 sujets.
- Si vous utilisez l'abonnement par lot pour abonner des instances d'application, chaque requête est limitée à 1 000 instances d'application.
Limitation des abonnements
Le taux d'ajout ou de suppression d'abonnements à des sujets est limité à 3 000 requêtes par seconde par projet.
La fréquence des nouveaux abonnements est limitée par projet. Si vous envoyez trop
de requêtes d'abonnement sur une courte période, FCM
serveurs répondent avec une 429 RESOURCE_EXHAUSTED ("QUOTA_EXHAUSTED")
réponse. Réessayez avec un intervalle exponentiel entre les tentatives.
Limitation de la diffusion
La diffusion de messages consiste à envoyer un message à plusieurs appareils, par exemple lorsque vous ciblez des sujets et des groupes, ou lorsque vous utilisez le compositeur de notifications pour cibler des audiences ou des segments d'utilisateurs.
La diffusion de messages n'est pas instantanée. Il arrive donc que plusieurs diffusions soient en cours simultanément. Nous limitons le nombre de diffusions de messages simultanées par projet à 1 000. Au-delà de cette limite, nous pouvons rejeter les requêtes de diffusion supplémentaires ou différer la diffusion des requêtes jusqu'à ce que certaines des diffusions déjà en cours soient terminées.
Le taux de diffusion réel réalisable est influencé par le nombre de projets demandant des diffusions en même temps. Un taux de diffusion de 10 000 requêtes par seconde pour un projet individuel n'est pas rare, mais ce nombre n'est pas garanti et résulte de la charge totale du système. Il est important de noter que la capacité de diffusion disponible est divisée entre les projets et non entre les requêtes de diffusion. Par conséquent, si votre projet comporte deux diffusions en cours, chaque diffusion ne verra que la moitié du taux de diffusion disponible. Pour maximiser la vitesse de diffusion, nous vous recommandons de n'avoir qu'une seule diffusion active à la fois.
Étapes suivantes
- Découvrez comment gérer les abonnements à des sujets à l'aide du SDK Admin ou de votre application cliente.
- Découvrez comment envoyer des messages à des sujets à l'aide du SDK Admin ou de l'API HTTP FCM v1.