Nachrichten an Gerätegruppen senden

Mit der Messaging-Funktion für Gerätegruppen können Sie einer einzelnen Gruppe mehrere Geräte hinzufügen. Das ist ähnlich wie beim Thema-Messaging, umfasst aber die Authentifizierung, um sicherzustellen, dass die Gruppenmitgliedschaft nur von Ihren Servern verwaltet wird.

Wenn Sie beispielsweise verschiedene Nachrichten an verschiedene Telefonmodelle senden möchten, können Ihre Server Registrierungen zu den entsprechenden Gruppen hinzufügen oder daraus entfernen und die entsprechende Nachricht an jede Gruppe senden. Das Messaging für Gerätegruppen unterscheidet sich vom Thema-Messaging dadurch, dass Gerätegruppen von Ihren Servern aus verwaltet werden und nicht direkt in Ihrer Anwendung.

Die maximale 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:

Registrierungstokens für jedes Gerät abrufen, das Sie der Gruppe hinzufügen möchten.
Den notification_key erstellen, der 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 App-Server erstellen.

Die grundlegende Verwaltung von Gerätegruppen – das Erstellen und Entfernen von Gruppen sowie das Hinzufügen oder Entfernen von Geräten – erfolgt über die HTTP v1 API. Dabei werden kurzlebige Tokens verwendet, um Sendeanfragen zu autorisieren. Eine Liste der unterstützten Schlüssel finden Sie unter Schlüssel für die Verwaltung von Gerätegruppen.

Gerätegruppen auf dem App-Server verwalten

Gerätegruppe erstellen

Senden Sie zum Erstellen einer Gerätegruppe eine POST-Anfrage mit einem Namen für die Gruppe und einer Liste von Registrierungstokens für die Geräte. FCM gibt einen neuen notification_key zurück, der 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...",
                        ... ]
}

Der notification_key_name ist ein Name oder eine ID (z.B. ein Nutzername), der für eine bestimmte Gruppe eindeutig ist. Der notification_key_name und notification_key sind für eine Gruppe von Registrierungstokens eindeutig. Wenn Sie mehrere Client-Apps für dieselbe Absender-ID haben, muss der notification_key_name für jede Client-App eindeutig sein. So wird sichergestellt, dass Nachrichten nur an die gewünschte Ziel-App gesendet werden.

Antwortformat

Bei einer erfolgreichen Anfrage wird ein notification_key wie der folgende zurückgegeben:

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

Speichern Sie den notification_key und den entsprechenden notification_key_name, um sie in nachfolgenden Vorgängen zu verwenden.

Benachrichtigungsschlüssel abrufen

Wenn Sie einen vorhandenen Benachrichtigungsschlüssel abrufen müssen, verwenden Sie den notification_key_name in einer GET-Anfrage wie unten 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 einen eindeutigen codierten String zurück. Obwohl jeder String wie ein anderer Schlüssel aussieht, ist er tatsächlich ein gültiger notification_key-Wert.

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

Wenn Sie Geräte zu einer vorhandenen Gruppe hinzufügen oder daraus entfernen möchten, senden Sie eine POST-Anfrage, bei der der Parameter operation auf add oder remove gesetzt ist. Geben Sie die Registrierungstokens für das Hinzufügen oder Entfernen an.

HTTP-POST-Anfrage

Wenn Sie beispielsweise ein Gerät mit dem Registrierungstoken bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1... zu appUser-Chris hinzufügen möchten, senden Sie diese Anfrage:

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": "add",
   "notification_key_name": "appUser-Chris",
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ",
   "registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."]
}

Antwortformat

Bei einer erfolgreichen Anfrage zum Hinzufügen oder Entfernen eines Geräts wird ein notification_key wie der folgende zurückgegeben:

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

Schlüssel für die Verwaltung von Gerätegruppen

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

Parameter	Nutzung	Beschreibung
`operation`	Erforderlich, String	Der auszuführende Vorgang.Gültige Werte sind `create`, `add` und `remove`.
`notification_key_name`	Erforderlich, String	Der vom Nutzer definierte Name der Gerätegruppe, die erstellt oder geändert werden soll.
`notification_key`	Erforderlich (außer für den Vorgang `create`, String)	Eindeutige ID der Gerätegruppe. Dieser Wert wird in der Antwort für einen erfolgreichen Vorgang `create` zurückgegeben und ist für alle nachfolgenden Vorgänge für die Gerätegruppe erforderlich.
`registration_ids`	Erforderlich, Array von Strings	Die Geräte-Tokens, die hinzugefügt oder entfernt werden sollen. Wenn Sie alle vorhandenen Registrierungstokens aus einer Gerätegruppe entfernen, löscht FCM die Gerätegruppe.