Interfejs API identyfikatora instancji umożliwia zintegrowanie identyfikatora instancji z aplikacją na Androida lub iOS. Identyfikator instancji zapewnia unikalny identyfikator każdej instancji aplikacji oraz mechanizm uwierzytelniania i autoryzowania działań. InstanceID jest długotrwały, ale może wygasnąć z tych powodów:
- Przywrócenie ustawień fabrycznych na urządzeniu.
- Odinstalowanie aplikacji przez użytkownika.
- Wykonanie przez użytkownika w aplikacji czynności „Wyczyść dane”.
- Długi okres nieużywania urządzenia (czas zależy od urządzenia i regionu).
- Usługa identyfikatora instancji wykrywa nadużycie lub błędy i resetuje
InstanceID. - Kod po stronie serwera, jeśli aplikacja kliencka wymaga tej funkcji.
Usługa identyfikatora instancji powiadamia aplikację o resecie InstanceID za pomocą
wywołania zwrotnego do InstanceIDListenerService. Jeśli aplikacja otrzyma to powiadomienie, musi wywołać getToken() i pobrać nowy InstanceID oraz zaktualizować swoje serwery.
Użyj metody getToken, aby udowodnić, że jesteś właścicielem InstanceID, i umożliwić serwerom dostęp do danych lub usług powiązanych z aplikacją. Metoda ta jest zgodna ze wzorcami OAuth2 i wymaga podania authorizedEntity oraz scope. authorizedEntity może być identyfikatorem projektu lub innym InstanceID. Określa ona usługi, które są uprawnione do korzystania z wygenerowanego tokena. scope określa konkretną usługę lub dane, do których token umożliwia dostęp.
Więcej informacji o interfejsie API identyfikatora instancji: