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