Örnek Kimliği API'si, örnek kimliğini Android veya iOS uygulamanıza entegre etmenize olanak tanır. Örnek kimliği, uygulamanızın her örneği için benzersiz bir tanımlayıcı ve işlemleri kimlik doğrulama ve yetkilendirme mekanizması sağlar. InstanceID uzun ömürlüdür ancak aşağıdaki nedenlerle süresi dolabilir:
- Cihazın fabrika ayarlarına sıfırlanması.
- Kullanıcı uygulamayı kaldırır.
- Kullanıcı, uygulamada "Verileri temizle" işlemini gerçekleştirir.
- Cihazın uzun süre kullanılmaması (zaman aralığı cihaz ve bölgeye göre belirlenir).
- Instance ID hizmeti, kötüye kullanımı veya hataları algılar ve
InstanceIDdeğerini sıfırlar. - İstemci uygulamanız bu işlevi gerektiriyorsa sunucu tarafı kodu.
Örnek Kimliği hizmeti, InstanceID sıfırlandığında InstanceIDListenerService geri çağırma işleviyle uygulamanızı bilgilendirir. Uygulamanız bu bildirimi alırsa getToken() işlevini çağırmalı, yeni InstanceID değerini almalı ve sunucularını güncellemelidir.
getToken yöntemini kullanarak InstanceID'nin sahipliğini kanıtlayın ve sunucuların uygulamayla ilişkili verilere veya hizmetlere erişmesine izin verin. Bu yöntem, OAuth2'nin kalıplarını izler ve authorizedEntity ile scope gerektirir. authorizedEntity, bir proje kimliği veya başka bir InstanceID olabilir ve oluşturulan jetonu kullanmaya yetkili hizmetleri belirler. scope, jetonun erişime izin verdiği belirli hizmeti veya verileri belirler.
Aşağıdaki platformlar için örnek kimliği API'si hakkında daha fazla bilgi edinin: