Instanz-ID-API
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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
InstanceID zurü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 das Zurücksetzen der InstanceID. 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 bestimmten Dienst oder die Daten, auf die das Token Zugriff gewährt.
Weitere Informationen zur Instance ID API für:
Android
iOS
Server
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-31 (UTC)."],[[["\u003cp\u003eThe Instance ID API provides a unique identifier for each app instance and enables authentication and authorization.\u003c/p\u003e\n"],["\u003cp\u003eInstance IDs are long-lived but can expire due to various factors like device reset, uninstallation, data clearing, extended inactivity, or service-detected issues.\u003c/p\u003e\n"],["\u003cp\u003eUpon Instance ID reset, apps are notified and must retrieve a new ID using \u003ccode\u003egetToken()\u003c/code\u003e and update their servers.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetToken()\u003c/code\u003e method, using OAuth2 patterns, verifies Instance ID ownership and grants server access to associated data or services based on authorized entity and scope.\u003c/p\u003e\n"]]],[],null,["# Instance ID API\n\nThe Instance ID API lets you integrate Instance ID with your Android\nor iOS app. Instance ID provides a unique identifier for each instance of\nyour app and a mechanism to authenticate and authorize actions. The `InstanceID` is long\nlived, but may expire for the following reasons:\n\n- Device factory reset.\n- User uninstalls the app.\n- User performs \"Clear Data\" in the app.\n- Device unused for an extended period (device and region determines the timespan).\n- Instance ID service detects abuse or errors and resets the `InstanceID`.\n- Server-side code if your client app requires that functionality.\n\nThe Instance ID service notifies your app of an `InstanceID` reset via\ncallback to a `InstanceIDListenerService`. If your app receives this\nnotification, it must call `getToken()` and retrieve the new `InstanceID`,\nand update its servers.\n\nUse the `getToken` method to prove the ownership of the `InstanceID` and to allow\nservers to access data or services associated with the app. The method follows\nthe patterns of OAuth2, and requires an `authorizedEntity` and `scope`. The\n`authorizedEntity` can be a project ID or another `InstanceID`, and it determines\nthe services that are authorized to use the generated token. The `scope`\ndetermines the specific service or data to which the token allows access.\n\nLearn more about the Instance ID API for:\n\n[Android](/instance-id/reference/android/api)\n[iOS](/instance-id/reference/ios/api)\n[Server](/instance-id/reference/server)"]]
