Ihre Serverumgebung und FCM

Die Serverseite von Firebase Cloud Messaging besteht aus zwei Komponenten:

  • Das von Google bereitgestellte FCM-Backend
  • Ihr App-Server oder eine andere vertrauenswürdige Serverumgebung, in der Ihre Serverlogik ausgeführt wird, z. B. Cloud Functions for Firebase oder andere von Google verwaltete Cloud-Umgebungen.

Ihr App-Server oder Ihre vertrauenswürdige Serverumgebung sendet Nachrichtenanfragen an das FCM-Backend, das Nachrichten dann an Client-Apps weiterleitet, die auf den Geräten der Nutzer ausgeführt werden.

Anforderungen an die vertrauenswürdige Serverumgebung

Ihre App-Serverumgebung muss die folgenden Kriterien erfüllen:

  • Sie können korrekt formatierte Nachrichtenanfragen an das FCM-Backend senden.
  • Kann Anfragen verarbeiten und mit exponentiellem Backoff noch einmal senden.
  • Sie können Anmeldedaten für die Serverautorisierung und Clientregistrierungstokens sicher speichern.

Serveroption auswählen

Sie müssen festlegen, wie Sie mit FCM-Servern interagieren möchten: entweder über Firebase Admin SDK oder das Raw-Protokoll. Aufgrund der Unterstützung in gängigen Programmiersprachen und der praktischen Methoden zur Authentifizierung und Autorisierung wird die Firebase Admin SDK empfohlen.

Folgende Optionen stehen für die Interaktion mit FCM-Servern zur Verfügung:

Firebase Admin SDK für FCM

Die Admin FCM API übernimmt die Authentifizierung beim Backend und erleichtert das Senden von Nachrichten und die Verwaltung von Themenabos. Mit der Firebase Admin SDK können Sie:

  • Nachrichten an einzelne Geräte senden
  • Nachrichten an Themen und Bedingungsausdrücke senden, die mit einem oder mehreren Themen übereinstimmen
  • Geräten Themen zuweisen und Themen von Geräten entfernen
  • Nachrichtenn-Nutzlast für verschiedene Zielplattformen erstellen

Das Admin Node.js SDK bietet Methoden zum Senden von Nachrichten an Gerätegruppen.

Informationen zum Einrichten der Firebase Admin SDK finden Sie unter Firebase Admin SDK auf dem Server hinzufügen. Wenn Sie bereits ein Firebase-Projekt haben, beginnen Sie mit SDK hinzufügen. Aktivieren Sie außerdem die Cloud Messaging API auf der Seite mit den Cloud Messaging-Einstellungen für Ihr Projekt. Nachdem die Firebase Admin SDK installiert ist, können Sie mit dem Schreiben von Logik beginnen, um Sendeanfragen zu erstellen.

FCM-Serverprotokoll

FCM bietet die FCM HTTP v1 API für Entwickler, die ein Rohserverprotokoll bevorzugen.

Um eine Nachricht zu senden, sendet der App-Server eine POST-Anfrage mit einem HTTP-Header und einem HTTP-Text, der aus JSON-Schlüssel/Wert-Paaren besteht. Weitere Informationen zu den Optionen für Header und Textkörper finden Sie unter App-Server-Sendeanfragen erstellen.