A API Instance ID permite integrar o ID da instância ao seu 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
tem longa
duração, mas pode expirar pelos seguintes motivos:
- Redefinir o dispositivo para a configuração original
- O usuário desinstala o app.
- O usuário executa a ação "Limpar dados" no app.
- 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 redefinição de InstanceID
por meio de
callback para um InstanceIDListenerService
. Se o app receber essa
notificação, ele precisará chamar getToken()
, extrair o novo InstanceID
e atualizar os servidores.
Use o método getToken
para provar a propriedade de InstanceID
e permitir que os servidores acessem dados ou serviços associados ao app. O método segue os padrões do OAuth2 e requer authorizedEntity
e scope
. O
authorizedEntity
pode ser um ID de projeto ou outro InstanceID
e determina
os serviços que estão autorizados a usar o token gerado. O scope
determina os dados ou serviços específicos aos quais o token permite o acesso.
Saiba mais sobre a API Instance ID para: