Mit der Instance ID API können Sie die Instance ID in Ihre Android- oder iOS-App einbinden. Die Instance ID bietet eine eindeutige Kennung für jede Instanz Ihrer App und einen Mechanismus zum Authentifizieren und Autorisieren von Aktionen. Die InstanceID ist langfristig gültig, kann aber aus folgenden Gründen ablaufen:
- Gerät auf die Werkseinstellungen zurückgesetzt
- Nutzer deinstalliert die App
- Nutzer führt in der App die Aktion „Daten löschen“ aus
- Gerät wurde längere Zeit nicht verwendet (Zeitraum hängt vom Gerät und der Region ab)
- Der Instance ID-Dienst erkennt Missbrauch oder Fehler und setzt die
InstanceIDzurück - Serverseitiger Code, wenn Ihre Client-App diese Funktion erfordert
Der Instance ID-Dienst benachrichtigt Ihre App über ein InstanceID Zurücksetzen via
Callback an ein InstanceIDListenerService. Wenn Ihre App diese Benachrichtigung erhält, muss sie getToken() aufrufen, die neue InstanceID abrufen und ihre Server aktualisieren.
Mit der Methode getToken können Sie den Besitz der InstanceID nachweisen und Servern Zugriff auf Daten oder Dienste gewähren, die mit der App verknüpft sind. Die Methode folgt den Mustern von OAuth2 und erfordert eine authorizedEntity und einen scope. Die authorizedEntity kann eine Projekt-ID oder eine andere InstanceID sein und bestimmt die Dienste, die das generierte Token verwenden dürfen. Der scope bestimmt den spezifischen Dienst oder die spezifischen Daten, auf die das Token Zugriff gewährt.
Weitere Informationen zur Instance ID API für: