A API Instance ID permite integrar o Instance ID ao seu app Android
ou iOS. O Instance ID fornece um identificador exclusivo para cada instância do
app e um mecanismo para autenticar e autorizar ações. O InstanceID
tem vida
longa, 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 opçã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 de instância detecta abusos ou erros e redefine o
InstanceID
. - Código do lado do servidor, se o app cliente exigir essa funcionalidade.
O serviço de ID de 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()
e recuperar o novo InstanceID
e atualizar os servidores.
Use o método getToken
para provar 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 de projeto ou outro InstanceID
e determina
os serviços autorizados a usar o token gerado. O scope
determina o serviço ou dados específicos a que o token permite acesso.
Saiba mais sobre a API Instance ID para: