Mit der Instance ID API können Sie die Instanz-ID in Ihre Android- oder iOS-App einbinden. Die Instanz-ID stellt eine eindeutige Kennung für jede Instanz Ihrer App und einen Mechanismus zum Authentifizieren und Autorisieren von Aktionen bereit. Das InstanceID
ist langlebig, kann aber aus folgenden Gründen ablaufen:
- Das Gerät wurde auf die Werkseinstellungen zurückgesetzt.
- Der Nutzer deinstalliert die App.
- Der Nutzer führt in der App „Daten löschen“ aus.
- Gerät wurde ü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 die Clientanwendung diese Funktion erfordert
Der Instanz-ID-Dienst benachrichtigt Ihre App über das Zurücksetzen von InstanceID
über einen Callback an InstanceIDListenerService
. Wenn deine App diese Benachrichtigung erhält, muss sie getToken()
aufrufen, das neue InstanceID
abrufen und seine Server aktualisieren.
Verwenden Sie die Methode getToken
, um die Inhaberschaft der InstanceID
nachzuweisen und den Servern den Zugriff auf Daten oder Dienste zu ermöglichen, die mit der Anwendung verknüpft sind. Die Methode folgt den Mustern von OAuth2 und erfordert authorizedEntity
und scope
. Die authorizedEntity
kann eine Projekt-ID oder eine andere InstanceID
sein. Damit werden die Dienste bestimmt, die zur Verwendung des generierten Tokens autorisiert sind. Das scope
bestimmt den spezifischen Dienst oder die Daten, auf die das Token Zugriff gewährt.
Weitere Informationen zur Instance ID API für: