L'API Instance ID vous permet d'intégrer l'ID d'instance à votre application Android ou iOS. L'ID d'instance fournit un identifiant unique pour chaque instance de votre application, ainsi qu'un mécanisme permettant d'authentifier et d'autoriser les actions. Le InstanceID
a une longue durée de vie, mais peut expirer pour les raisons suivantes:
- Rétablir la configuration d'usine de l'appareil.
- L'utilisateur désinstalle l'application.
- L'utilisateur effectue l'opération "Effacer les données" dans l'application.
- Appareil inutilisé pendant une période prolongée (l'appareil et la région déterminent la période).
- Le service d'ID d'instance détecte les utilisations abusives ou les erreurs, et réinitialise
InstanceID
. - Le code côté serveur si votre application cliente nécessite cette fonctionnalité.
Le service d'ID d'instance informe votre application d'une réinitialisation InstanceID
via un rappel à un InstanceIDListenerService
. Si votre application reçoit cette notification, elle doit appeler getToken()
, récupérer le nouveau InstanceID
et mettre à jour ses serveurs.
Utilisez la méthode getToken
pour prouver que vous êtes le propriétaire de InstanceID
et pour autoriser les serveurs à accéder aux données ou aux services associés à l'application. Cette méthode suit les modèles d'OAuth2 et nécessite des éléments authorizedEntity
et scope
. authorizedEntity
peut être un ID de projet ou un autre élément InstanceID
, et 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 autorise l'accès.
Apprenez-en davantage sur l'API Instance ID pour les éléments suivants: