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
InstanceIDzurü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: