A API Instance ID permite integrar o ID da instância ao app Android ou iOS. O ID da instância fornece um identificador exclusivo para cada instância do app e um mecanismo para autenticar e autorizar ações. O InstanceID é de longa duração, mas pode expirar pelos seguintes motivos:
- Redefinição de fábrica do dispositivo.
- O usuário desinstala o app.
- O usuário executa a opção "Limpar dados" no app.
- O dispositivo não é usado por um período prolongado (o dispositivo e a região determinam o período).
- O serviço de ID da instância detecta abuso ou erros e redefine o
InstanceID. - Código do lado do servidor, se o app cliente exigir essa funcionalidade.
O serviço de ID da instância notifica seu app sobre uma InstanceID redefinição via
callback para um InstanceIDListenerService. Se o app receber essa notificação, ele precisará chamar getToken() e recuperar o novo InstanceID, além de atualizar os servidores.
Use o método getToken para comprovar a propriedade do InstanceID e permitir que os servidores acessem dados ou serviços associados ao app. O método segue os padrões do OAuth2 e exige um authorizedEntity e um scope. O authorizedEntity pode ser um ID do projeto ou outro InstanceID e determina os serviços autorizados a usar o token gerado. O scope determina o serviço ou os dados específicos a que o token permite acesso.
Saiba mais sobre a API Instance ID para: