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
seu 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 "Limpar dados" no app.
- Dispositivo não usado por um período prolongado (o período é determinado pelo dispositivo e pela região).
- 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 Instance ID notifica seu app sobre uma redefinição de InstanceID
por
callback para um InstanceIDListenerService
. Se o app receber essa
notificação, ele precisará chamar getToken()
, recuperar o novo InstanceID
e atualizar os servidores.
Use o método getToken
para provar a propriedade do InstanceID
e permitir que
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 de 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: