Mit der Instance ID API können Sie die Instanz-ID in Ihre Android- oder iOS-App einbinden. Die Instanz-ID bietet eine eindeutige Kennung für jede Instanz der Anwendung und einen Mechanismus zum Authentifizieren und Autorisieren von Aktionen. InstanceID
ist langlebig, kann jedoch aus folgenden Gründen ablaufen:
- Gerät auf Werkseinstellungen zurückgesetzt.
- Der Nutzer deinstalliert die App.
- Der Nutzer führt in der App die Aktion „Daten löschen“ aus.
- Gerät über einen längeren Zeitraum nicht verwendet (Gerät und Region bestimmen die Zeitspanne).
- Der Instanz-ID-Dienst erkennt Missbrauch oder Fehler und setzt
InstanceID
zurück. - Serverseitiger Code, wenn Ihre Client-App diese Funktion benötigt.
Der Instanz-ID-Dienst benachrichtigt Ihre Anwendung über einen Rückruf von InstanceID
durch einen InstanceIDListenerService
-Callback. Wenn deine Anwendung diese Benachrichtigung empfängt, muss sie getToken()
aufrufen, das neue InstanceID
abrufen und ihre Server aktualisieren.
Verwenden Sie die Methode getToken
, um die Inhaberschaft von InstanceID
nachzuweisen und Server den Zugriff auf Daten oder Dienste zu ermöglichen, die der Anwendung zugeordnet sind. Die Methode folgt dem OAuth2-Muster und erfordert authorizedEntity
und scope
. Die authorizedEntity
kann eine Projekt-ID oder ein anderer InstanceID
sein und bestimmt die Dienste, die zur Verwendung des generierten Tokens berechtigt sind. Die scope
bestimmt den Dienst oder die Daten, auf die bzw. die das Token Zugriff gewährt.
Weitere Informationen zur Instance ID API für: