Mit der Instance ID API können Sie die Instanz-ID in Ihre Android- oder iOS-App einbinden. Die Instanz-ID bietet einen eindeutigen Bezeichner für jede Instanz Ihrer App sowie einen Mechanismus zum Authentifizieren und Autorisieren von Aktionen. Das InstanceID ist langlebig, kann aber aus folgenden Gründen ablaufen:
- Gerät auf die Werkseinstellungen zurücksetzen.
- Der Nutzer deinstalliert die App.
- Der Nutzer führt in der App die Aktion „Daten löschen“ aus.
- Das Gerät wurde über einen längeren Zeitraum nicht verwendet (Gerät und Region bestimmen den Zeitraum).
- Der Instance ID-Dienst erkennt Missbrauch oder Fehler und setzt die
InstanceIDzurück. - Serverseitiger Code, wenn Ihre Client-App diese Funktion benötigt.
Der Instance ID-Dienst benachrichtigt Ihre App über das Zurücksetzen der InstanceID über einen Callback an eine 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 die Inhaberschaft von InstanceID nachweisen und Servern den Zugriff auf Daten oder Dienste ermöglichen, die mit der App verknüpft sind. Die Methode folgt den Mustern von OAuth2 und erfordert authorizedEntity und scope. authorizedEntity kann eine Projekt-ID oder ein anderes InstanceID sein. Es bestimmt die Dienste, die das generierte Token verwenden dürfen. Die scope bestimmt den spezifischen Dienst oder die spezifischen Daten, auf die mit dem Token zugegriffen werden kann.
Weitere Informationen zur Instance ID API für: