Interfejs Instance ID API umożliwia integrację z aplikacją na Androida lub iOS. Identyfikator Instance ID zapewnia unikalny identyfikator każdej instancji aplikacji oraz mechanizm uwierzytelniania i autoryzacji działań. InstanceID
jest długotrwały, ale może wygasnąć z tych powodów:
- Przywrócenie urządzenia do ustawień fabrycznych.
- Użytkownik odinstalowuje aplikację.
- Użytkownik wykonuje w aplikacji operację „Wyczyść dane”.
- Urządzenie nieużywane przez dłuższy czas (okres ten zależy od urządzenia i regionu).
- Usługa identyfikatorów instancji wykrywa nadużycia lub błędy i resetuje
InstanceID
. - kod po stronie serwera, jeśli aplikacja klienta wymaga tej funkcji.
Usługa Instance ID powiadamia aplikację o zresetowaniu InstanceID
za pomocą wywołania zwrotnego do InstanceIDListenerService
. Jeśli aplikacja otrzyma to powiadomienie, musi wywołać funkcję getToken()
i pobrać nową wartość InstanceID
, a następnie zaktualizować swoje serwery.
Użyj metody getToken
, aby udowodnić, że jesteś właścicielem InstanceID
, i zezwolić serwerom na dostęp do danych lub usług powiązanych z aplikacją. Ta metoda jest zgodna z wzorcem OAuth 2 i wymaga użycia authorizedEntity
i scope
. authorizedEntity
może być identyfikatorem projektu lub innym InstanceID
i określa usługi, które mają uprawnienia do używania wygenerowanego tokena. scope
określa konkretną usługę lub dane, do których token umożliwia dostęp.
Dowiedz się więcej o interfejsie Instance ID API w przypadku: