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 zur Authentifizierung und Autorisierung von Aktionen. Die InstanceID ist langlebig, kann aber aus folgenden Gründen ablaufen:
- Gerät auf die Werkseinstellungen zurückgesetzt.
- Der Nutzer deinstalliert die App.
- Der Nutzer wählt in der App die Option „Daten löschen“ aus.
- Das Gerät wurde über einen längeren Zeitraum nicht verwendet. Die Zeitspanne wird vom Gerät und der Region bestimmt.
- Der Instanz-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 einen Rückruf an eine InstanceIDListenerService über ein InstanceID-Zurücksetzen. Wenn Ihre App diese Benachrichtigung erhält, muss sie getToken() aufrufen, die neue InstanceID abrufen und ihre Server aktualisieren.
Verwenden Sie die Methode getToken, um den Inhaber der InstanceID nachzuweisen und Servern den Zugriff auf Daten oder Dienste zu erlauben, die mit der App verknüpft sind. Die Methode folgt den Mustern von OAuth2 und erfordert eine authorizedEntity und eine scope. Die authorizedEntity kann eine Projekt-ID oder eine andere InstanceID sein. Sie bestimmt die Dienste, die das generierte Token verwenden dürfen. Die scope bestimmt den spezifischen Dienst oder die Daten, auf die das Token Zugriff gewährt.
Weitere Informationen zur Instance ID API für: