Nachrichten an Gerätegruppen in C++ senden

Bei Nachrichten an Gerätegruppen können Sie einer einzelnen Gruppe mehrere Geräte hinzufügen. Dies ähnelt dem Topic Messaging, beinhaltet jedoch eine Authentifizierung, um sicherzustellen, Die Gruppenmitgliedschaft wird nur von Ihren Servern verwaltet. Wenn Sie beispielsweise unterschiedliche Nachrichten an verschiedene Smartphone-Modelle senden möchten, können Ihre Server den entsprechenden Gruppen Registrierungen hinzufügen oder entfernen und die entsprechende Nachricht an jede Gruppe senden. Die Nachrichtenübermittlung an Gerätegruppen unterscheidet sich von der Nachrichtenübermittlung an Themen dadurch, dass Gerätegruppen von Ihren Servern aus verwaltet werden, anstatt direkt in Ihrer Anwendung.

Die maximal zulässige Anzahl von Mitgliedern für einen Benachrichtigungsschlüssel beträgt 20.

Gerätegruppen verwalten

Bevor Sie Nachrichten an eine Gerätegruppe senden, müssen Sie Folgendes tun:

  1. Sie erhalten Registrierungstokens für jedes Gerät, das Sie hinzufügen möchten an die Gruppe gesendet.

  2. Erstellen Sie die notification_key, die die Gerätegruppe identifiziert, indem eine bestimmte Gruppe (in der Regel ein Nutzer) allen zugehörigen Registrierungstokens der Gruppe zugeordnet wird. Sie können Benachrichtigungsschlüssel auf dem Anwendungsserver erstellen.

Grundlegende Verwaltung von Gerätegruppen – Gruppen erstellen und entfernen und das Hinzufügen oder Entfernen von Geräten – erfolgt über die HTTP v1 API, mit kurzlebigen Tokens, Sendeanfragen autorisieren. Eine Liste der unterstützten Schlüssel finden Sie unter Schlüssel für die Gerätegruppenverwaltung.

Gerätegruppen auf dem Anwendungsserver verwalten

Gerätegruppe erstellen

Wenn du eine Gerätegruppe erstellen möchtest, sende eine POST-Anfrage mit einem Namen für die Gruppe und eine Liste von Registrierungstokens für die Geräte. FCM gibt eine neue notification_key zurück, die die Gerätegruppe darstellt.

HTTP-POST-Anfrage

Senden Sie eine Anfrage wie die folgende an https://fcm.googleapis.com/fcm/notification: 

https://fcm.googleapis.com/fcm/notification
Content-Type:application/json
access_token_auth: true
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
project_id:SENDER_ID

{
   "operation": "create",
   "notification_key_name": "appUser-Chris",
   "registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
                        "cR1rjyj4_Kc:APA91bGusqbypSuMdsh7jSNrW4nzsM...",
                        ... ]

notification_key_name ist ein Name oder eine Kennung (z. B. ein Nutzername), der bzw. die für eine bestimmte Gruppe eindeutig ist. Die notification_key_name und notification_key sind für eine Registrierungsgruppe eindeutig Tokens. notification_key_name muss unbedingt eindeutig pro Client-App, wenn Sie mehrere Client-Apps für dieselbe Absender-ID aus. Dadurch wird sichergestellt, dass Nachrichten nur an die gewünschte Ziel-App gesendet werden.

Antwortformat

Bei einer erfolgreichen Anfrage wird eine notification_key wie die folgende zurückgegeben:

{
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}

Speichern Sie notification_key und die entsprechende notification_key_name für die nachfolgenden Vorgänge.

Benachrichtigungsschlüssel abrufen

Wenn du einen vorhandenen Benachrichtigungsschlüssel abrufen möchtest, verwende notification_key_name in einer GET-Anfrage, wie hier gezeigt: 

https://fcm.googleapis.com/fcm/notification?notification_key_name=appUser-Chris
Content-Type:application/json
access_token_auth: true
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
project_id:SENDER_ID
{}

Für jede GET-Anfrage für einen bestimmten Benachrichtigungsschlüsselnamen gibt der Server gibt einen eindeutigen codierten String zurück. Auch wenn jeder String wie ein anderer Schlüssel erscheint, ist er in Wirklichkeit ein gültiger Wert für „notification_key“.

Geräte zu einer Gerätegruppe hinzufügen oder daraus entfernen

Sende eine POST-Anfrage, um Geräte einer bestehenden Gruppe hinzuzufügen oder von ihr zu entfernen. mit dem Parameter operation auf add oder remove und geben Sie zum Hinzufügen oder Entfernen.

HTTP-POST-Anfrage

Wenn du beispielsweise appUser-Chris ein Gerät mit dem Registrierungstoken bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1... hinzufügen möchtest, sendest du diese Anfrage: 

{
   "operation": "add",
   "notification_key_name": "appUser-Chris",
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ",
   "registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."]
}

Antwortformat

Eine erfolgreiche Anfrage zum Hinzufügen oder Entfernen eines Geräts gibt eine notification_key wie hier:

{
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}

Schlüssel zur Verwaltung von Gerätegruppen

In der folgenden Tabelle sind die Schlüssel zum Erstellen von Gerätegruppen aufgeführt und zum Hinzufügen und Entfernen von Mitgliedern.

Tabelle 10. Verwaltungsschlüssel für Gerätegruppen

Parameter Nutzung Beschreibung
operation Erforderlich, String Der auszuführende Vorgang. Gültige Werte sind create, add und remove.
notification_key_name Erforderlich, String Der benutzerdefinierte Name der zu erstellenden oder zu ändernden Gerätegruppe.
notification_key Erforderlich (außer für den create-Vorgang, String Die eindeutige Kennung der Gerätegruppe. Dieser Wert wird in der Antwort für eine erfolgreiche create-Anfrage zurückgegeben. Operation und ist ist für alle nachfolgenden Vorgänge in der Gerätegruppe erforderlich.
registration_ids Erforderliches String-Array Die Gerätetokens, die hinzugefügt oder entfernt werden sollen. Wenn Sie alle vorhandenen Registrierungstokens aus einer Gerätegruppe entfernen, löscht FCM die Gerätegruppe.

Downstream-Nachrichten an Gerätegruppen senden

Verwenden Sie die HTTP v1 API, um Nachrichten an Gerätegruppen zu senden. Wenn Sie derzeit mit den veralteten Sende-APIs für HTTP oder XMPP oder mit einer der älteren Versionen der Firebase Admin SDK für Node.js, die auf den alten Protokollen basieren, an Gerätegruppen senden, empfehlen wir Ihnen dringend, so bald wie möglich zur HTTP v1 API zu migrieren. Die Legacy-Sende-APIs wird im Juni 2024 deaktiviert und entfernt.

Das Senden von Nachrichten an eine Gerätegruppe funktioniert ähnlich wie das Senden von Nachrichten an eine Gerätegruppe Nachrichten an ein einzelnes Gerät gesendet, und zwar mit derselben Methode, Sendeanfragen autorisieren. Legen Sie das Feld token auf den Schlüssel für die Gruppenbenachrichtigung fest:

REST

POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1

Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA

{
   "message":{
      "token":"APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ",
      "data":{
        "hello": "This is a Firebase Cloud Messaging device group message!"
      }
   }
}

cURL-Befehl

curl -X POST -H "Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA" -H "Content-Type: application/json" -d '{
"message":{
   "data":{
     "hello": "This is a Firebase Cloud Messaging device group message!"
   },
   "token":"APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}}' https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send