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 d'authentification et d'autorisation des actions. Le InstanceID a une longue durée de vie, mais peut expirer pour les raisons suivantes:
- Configuration d'usine de l'appareil rétablie.
- L'utilisateur désinstalle l'application.
- L'utilisateur clique sur "Effacer les données" dans l'application.
- Appareil non utilisé 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 abus ou les erreurs et réinitialise le
InstanceID. - 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 de 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 du InstanceID et pour autoriser les serveurs à accéder aux données ou aux services associés à l'application. La méthode suit les modèles d'OAuth2, et nécessite des éléments authorizedEntity et scope. Le authorizedEntity peut être un ID de projet ou un autre InstanceID, et 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 autorise l'accès.
En savoir plus sur l'API Instance ID pour: