Interfejs Instance ID API umożliwia integrację identyfikatora instancji z aplikacją na Androida lub iOS. Zapewnia unikalny identyfikator każdej instancji aplikacji oraz mechanizm uwierzytelniania i autoryzowania działań. InstanceID
ma długi czas ważności, ale może wygasnąć z tych powodów:
- Ustawienia fabryczne urządzenia.
- Użytkownik odinstalowuje aplikację.
- Użytkownik wykonuje czynność „Wyczyść dane” w aplikacji.
- Urządzenie nie jest używane przez dłuższy czas (długość czasu zależy od urządzenia i regionu).
- Usługa identyfikatora instancji wykrywa nadużycia lub błędy i resetuje instancję
InstanceID
. - Kod po stronie serwera, jeśli aplikacja kliencka wymaga tej funkcji.
Usługa identyfikatora instancji powiadamia aplikację o zresetowaniu elementu InstanceID
, wywołując połączenie zwrotne do InstanceIDListenerService
. Jeśli aplikacja otrzyma to powiadomienie, musi wywołać metodę getToken()
, pobrać nowy plik InstanceID
oraz zaktualizować serwery.
Użyj metody getToken
, aby potwierdzić własność domeny InstanceID
i umożliwić serwerom dostęp do danych lub usług powiązanych z aplikacją. Metoda jest zgodna ze wzorcami OAuth2 i wymaga authorizedEntity
oraz scope
. authorizedEntity
może być identyfikatorem projektu lub innym elementem InstanceID
. Określa usługi, które są autoryzowane do korzystania z wygenerowanego tokena. scope
określa usługę lub dane, do których token zezwala.
Dowiedz się więcej o interfejsie Instance ID API dla: