API d'ID d'instance
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API Instance ID vous permet d'intégrer Instance ID à votre application Android ou iOS. Instance ID fournit un identifiant unique pour chaque instance de votre application, ainsi qu'un mécanisme permettant d'authentifier et d'autoriser des actions. Le InstanceID est de longue durée, mais il peut expirer pour les raisons suivantes :
- Rétablissement de la configuration d'usine de l'appareil.
- L'utilisateur désinstalle l'application.
- L'utilisateur efface les données dans l'application.
- Appareil inutilisé pendant une période prolongée (la durée dépend de l'appareil et de la région).
- Le service d'ID d'instance détecte les abus ou les erreurs et réinitialise
InstanceID.
- Code côté serveur si votre application cliente nécessite cette fonctionnalité.
Le service Instance ID avertit votre application d'une réinitialisation InstanceID via un rappel à un InstanceIDListenerService. Si votre application reçoit cette notification, elle doit appeler getToken() et récupérer le nouveau InstanceID, puis mettre à jour ses serveurs.
Utilisez la méthode getToken pour prouver la propriété de InstanceID et permettre aux serveurs d'accéder aux données ou aux services associés à l'application. La méthode suit les modèles OAuth2 et nécessite un authorizedEntity et un scope. authorizedEntity peut être un ID de projet ou un autre InstanceID. Il détermine les services autorisés à utiliser le jeton généré. Le scope détermine le service ou les données spécifiques auxquels le jeton permet d'accéder.
En savoir plus sur l'API Instance ID pour :
Android
iOS
Serveur
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).
[null,null,["Dernière mise à jour le 2025/09/05 (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)"]]
