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: