Auf dieser Seite finden Sie Hilfe zur Fehlerbehebung und Antworten auf häufig gestellte Fragen zu Cloud Messaging.
Was ist der Unterschied zwischen dem Benachrichtigungs-Composer und FCM?
Firebase Cloud Messaging bietet über seine Client-SDKs und das HTTP-Serverprotokoll eine vollständige Reihe von Messaging-Funktionen. Für Bereitstellungen mit komplexeren Messaging-Anforderungen ist FCM die richtige Wahl.
Der Benachrichtigungs-Composer ist eine einfache, serverlose Messaging-Lösung, die auf Firebase Cloud Messaging basiert. Mit der nutzerfreundlichen grafischen Konsole und den geringen Anforderungen an die Programmierung können Nutzer mit dem Benachrichtigungs-Composer Nachrichten senden, um Nutzer erneut anzusprechen und zu binden, das App-Wachstum zu fördern und Marketingkampagnen zu unterstützen.
| Funktionen |
|
Benachrichtigungs-Composer |
Cloud Messaging |
| Ziel |
Einzelnes Gerät |
|
|
|
Kunden, die Themen abonniert haben (z. B. Wetter) |
|
|
|
Clients in vordefinierten Nutzersegmenten (App, Version, Sprache) |
|
|
|
Clients in angegebenen Analytics-Zielgruppen |
|
|
|
Clients in Gerätegruppen |
|
|
|
Upstream vom Client zum Server |
|
|
| Nachrichtentyp |
Benachrichtigungen mit bis zu 2 KB |
|
|
|
Datennachrichten mit bis zu 4 KB |
|
|
| Lieferung |
Sofort |
|
|
|
Ortszeit des zukünftigen Clientgeräts |
|
|
| Analytics |
Integrierte Sammlung von Benachrichtigungsanalysen und Trichteranalysen |
|
|
Muss ich andere Firebase-Dienste verwenden, um FCM nutzen zu können?
Sie können Firebase Cloud Messaging als eigenständige Komponente verwenden, ohne andere Firebase-Dienste zu nutzen.
Warum erhalten meine Zielgeräte anscheinend keine Nachrichten?
Wenn es so aussieht, als hätten Geräte keine Nachrichten erhalten, prüfen Sie zuerst, ob eine der folgenden beiden möglichen Ursachen vorliegt:
Verarbeitung von Nachrichten im Vordergrund für Benachrichtigungen Client-Apps müssen Logik zur Nachrichtenverarbeitung hinzufügen, um Benachrichtigungsnachrichten zu verarbeiten, wenn sich die App auf dem Gerät im Vordergrund befindet. Weitere Informationen finden Sie für iOS und Android.
Einschränkungen durch die Netzwerk-Firewall: Wenn Ihre Organisation eine Firewall hat, die den Traffic zum oder vom Internet einschränkt, müssen Sie sie so konfigurieren, dass Verbindungen zu FCM zugelassen werden, damit Ihre Firebase Cloud Messaging-Client-Apps Nachrichten empfangen können. Die zu öffnenden Ports sind:
FCM verwendet normalerweise 5228, manchmal aber auch 5229 und 5230.
FCM stellt keine bestimmten IP-Adressen zur Verfügung. Sie sollten Ihre Firewall daher so konfigurieren, dass ausgehende Verbindungen zu allen IP-Adressen akzeptiert werden, die in den IP-Blöcken unter AS15169 von Google aufgeführt sind.
Warum wird onMessageReceived in meiner Android-App nicht aufgerufen?
Wenn sich Ihre App im Hintergrund befindet, werden Benachrichtigungsnachrichten in der Taskleiste angezeigt und onMessageReceived wird nicht aufgerufen. Bei Benachrichtigungen mit einer Daten-Nutzlast wird die Benachrichtigung in der Taskleiste angezeigt. Die Daten, die in der Benachrichtigung enthalten waren, können über den Intent abgerufen werden, der gestartet wird, wenn der Nutzer auf die Benachrichtigung tippt.
Weitere Informationen finden Sie unter Nachrichten empfangen und verarbeiten.
Warum erhalte ich den Fehler 404, wenn ich Nachrichten an eine aktive App-Instanz sende, die aus einer Sicherung wiederhergestellt wurde?
Die FID (Firebase-Installations-ID) ist die Kennung einer App-Instanz. Standardmäßig werden Firebase-Installationsdaten gesichert und wiederhergestellt. Im Wiederherstellungsfall haben die wiederhergestellte App-Instanz und die ursprüngliche App-Instanz also dieselbe FID. Da in FCM nur ein Token pro FID gespeichert wird, wird das Token der anderen App-Instanz entfernt, wenn sich eine App-Instanz bei FCM registriert. Dies führt zu 404-Fehlern.
Wir empfehlen Entwicklern, in ihrer App Folgendes zu tun:
- Ausschließen von Firebase-Installationsdaten in der Sicherung. Die Firebase-Installationsdaten werden in einer
PersistedInstallation....json-Datei gespeichert. Der Dateiname ist eine Konstante für eine App, z. B. <exclude domain="file" path="PersistedInstallation.W0R...GQ.json"
/>.
Apple hat angekündigt, das alte binäre Protokoll für APNs einzustellen. Muss ich etwas tun?
Nein. Firebase Cloud Messaging ist 2017 auf das HTTP/2-basierte APNs-Protokoll umgestiegen.
Wenn Sie FCM verwenden, um Benachrichtigungen an iOS-Geräte zu senden, müssen Sie nichts weiter tun.
FCM-Kontingente und ‑Limits
Wie benachrichtige ich innerhalb von 2 Minuten eine große Anzahl von Kunden?
Dieser Anwendungsfall kann nicht unterstützt werden. Ihr Traffic muss über 5 Minuten verteilt sein.
Meine App benachrichtigt Nutzer über Ereignisse und diese Nachrichten müssen sofort zugestellt werden, um mein Geschäftsmodell zu unterstützen. Kann ich mehr Kontingent erhalten?
Aus diesem Grund können wir keine Kontingenterhöhungen gewähren. Sie müssen Ihre Zugriffe über 5 Minuten verteilen, um Zugriffsspitzen zu vermeiden.
Meine Nachrichten beziehen sich auf geplante Ereignisse. Wie kann ich den gesamten Traffic zu Beginn der Stunde senden?
Wir empfehlen, die Benachrichtigungen mindestens 5 Minuten vor dem Event zu senden. Alternativ können Sie Datennachrichten senden und den Handler onMessageReceived Ihrer Plattform implementieren, um lokale Benachrichtigungen im Voraus zu planen.
429er-Fehler sind für mich und mein Unternehmen schwer zu beheben. Kann ich eine Ausnahme oder ein höheres Kontingent erhalten, um 429-Fehler zu vermeiden?
Wir wissen, dass Kontingentlimits eine Herausforderung sein können, aber sie sind wichtig, um die Zuverlässigkeit des Dienstes zu gewährleisten. Ausnahmen können wir nicht gewähren. Verwenden Sie Wiederholungsversuche, um 429-Fehler richtig zu behandeln.
Wie lange dauert es, bis mein Antrag auf Kontingenterhöhung bearbeitet wird?
Ihr Antrag auf Kontingenterhöhung hängt von Ihrer Nutzung von FCM ab. In jedem Fall erhalten Sie innerhalb weniger Arbeitstage eine Antwort. In einigen Fällen kann es zu einem Austausch bezüglich Ihrer Nutzung von FCM und verschiedenen Umständen kommen, was den Vorgang verlängern kann. Wenn alle Anforderungen erfüllt sind, werden die meisten Anfragen innerhalb von zwei Wochen bearbeitet.
Kann ich für eine temporäre Veranstaltung mehr Kontingent erhalten?
Sie können zusätzliches Kontingent für ein Event anfordern, das bis zu einem Monat dauert.
Reichen Sie die Anfrage mindestens einen Monat vor der Veranstaltung ein und geben Sie genau an, wann die Veranstaltung beginnt und endet. FCM wird sich nach Kräften bemühen, die Anfrage zu erfüllen. Wenn die Kontingenterhöhungen gewährt werden, werden sie nach dem Enddatum des Events wieder zurückgesetzt.
Kann sich mein aktuelles Kontingent ändern?
Google wird dies nicht leichtfertig tun, aber Kontingente können bei Bedarf geändert werden, um die Integrität des Systems zu schützen. Wenn möglich, benachrichtigt Google Sie im Voraus über solche Änderungen. Halten Sie Ihre Cloud MSA-Kontakte auf dem neuesten Stand, um die Wahrscheinlichkeit zu erhöhen, dass Sie Dienstankündigungen erhalten.
FCM Einstellung von Legacy-APIs
Serverseitige APIs, die im September 2026 eingestellt werden
Welche APIs und Funktionen werden eingestellt und außer Betrieb genommen? Was muss ich tun, wenn ich diese APIs verwende?
Alle InstanceId-Server-APIs und die Gerätegruppenfunktion werden eingestellt und am 29. September 2027 außer Betrieb genommen. In der folgenden Tabelle finden Sie weitere Informationen zu den eingestellten APIs/Funktionen und den erforderlichen Maßnahmen.
| API-Name
|
API-Endpunkt
|
Verwendungszweck
|
Auswirkungen auf Kunden
|
Maßnahme erforderlich
|
| InstanceId info API
|
https://iid.googleapis.com/iid/info
|
Informationen zu einer InstanceID / einem FCM-Token abrufen
|
Anfragen an diese API schlagen nach dem 29. September 2027 fehl.
|
Kunden, die die API zur Tokenvalidierung verwenden, sollten die FCM V1 Send API verwenden und validate_only auf „true“ setzen.
Kunden, die die API zum Abrufen von Informationen zu Themenabos verwenden, müssen zur neuen API für Themenabos migrieren.
|
| InstanceId-Themenabo-API
|
https://iid.googleapis.com/iid/v1/…/rel/topics
https://iid.googleapis.com/iid/v1:batchAdd
https://iid.googleapis.com/iid/v1:batchRemove
|
Abonnieren von Token für ein Thema über die Legacy-API für Themenabos.
|
Anfragen an diese API schlagen nach dem 29. September 2027 fehl.
|
Migrieren Sie zur neuen FCM-Server-API für Themenabos für Themenabos und ‑abmeldungen.
|
| InstanceId Batch Import API
|
https://iid.googleapis.com/iid/v1:batchImport
|
FCM-Tokens für iOS im Batch auf der Serverseite erstellen
|
Anfragen an diese API schlagen nach dem 29. September 2027 fehl.
Das Erstellen von FCM-Registrierungen aus APNs-Tokens auf dem Server wird nicht unterstützt.
|
Sie können APNs-Dienst von Apple verwenden, um Benachrichtigungen mit APNs-Tokens zu senden.
Wenn Sie die zusätzlichen Vorteile von FCM nutzen möchten, müssen Sie Ihre App in das FCM iOS SDK einbinden. Dadurch werden FCM-Registrierungen auf dem Client erstellt.
|
| API zur Verwaltung von Gerätegruppen
|
https://fcm.googleapis.com/fcm/notification
https://fcm.googleapis.com/gcm/notification
https://fcm.googleapis.com/iid/notification
https://fcm.googleapis.com/notification
|
Gerätegruppenmitglieder hinzufügen, entfernen oder abrufen.
|
Anfragen an diese API schlagen nach dem 29. September 2027 fehl.
|
Hier finden Sie eine Anleitung zur Migration.
Nachrichten können weiterhin an einzelne FCM-Registrierungen anstelle von Gruppentokens gesendet werden.
|
| An Gerätegruppe senden
|
https://fcm.googleapis.com/v1/projects/…/messages:send
|
Nachrichten an Gerätegruppen mit dem Benachrichtigungsschlüssel der Gruppe senden
|
Diese API funktioniert weiterhin, unterstützt aber nach dem 29. September 2027 keine Gerätegruppentokens mehr.
|
Wenn ich das Firebase Admin SDK zum Verwalten von Themenabos verwende, bin ich dann von der Einstellung betroffen? Wie gehe ich am besten vor?
Wenn Sie frühere Versionen des Firebase Admin SDK zum Verwalten von Themenabos verwenden, sind Sie von der Einstellung betroffen.
Sie müssen ein Upgrade Ihres Firebase Admin SDK auf die folgenden Versionen durchführen:
| Plattform
|
Betroffene Admin SDK-Version
|
Admin SDK-Version, auf die aktualisiert werden soll
|
| Node.js
|
<=14.4.0
|
>=14.5.0
|
| Python
|
<=7.6.0
|
>=7.7.0
|
| Java
|
<=9.10.0
|
Bald verfügbar
|
| Go
|
<=4.21.0
|
>=4.22.0
|
| .NET
|
<=3.6.0
|
Bald verfügbar
|
Wird mein Dienst vor dem 29. September 2027 herabgestuft?
Nein. Sie haben 12 Monate Zeit, um von den eingestellten APIs zu Alternativen zu migrieren, ohne dass der Dienst eingeschränkt wird. Wir empfehlen Ihnen dringend, die Migration so früh wie möglich zu planen, damit Sie nicht von der Außerbetriebnahme betroffen sind.
Nach dem 29. September 2027 sollten Sie beim Aufrufen eingestellter APIs Fehler erhalten.
Können neue Nutzer die eingestellten APIs/Funktionen vor der Deaktivierung nutzen?
Neue Nutzer können die eingestellten APIs/Funktionen vor dem 1. Januar 2027 einbinden.
Nach dem 1. Januar 2027 können neue Nutzer die verworfenen APIs nicht mehr verwenden.
Nutzer, die die verworfenen APIs verwenden, können dies noch bis zum 29. September 2027 tun.