تتيح لك واجهة Instance ID API دمج Instance ID مع جهاز Android
أو تطبيق iOS. يوفر رقم تعريف المثيل معرفًا فريدًا لكل مثيل
تطبيقك وآلية للمصادقة على الإجراءات والسماح بها إنّ InstanceID
طويل.
ولكنها قد تنتهي صلاحيتها للأسباب التالية:
- تمت إعادة ضبط الجهاز على الإعدادات الأصلية.
- يلغي المستخدم تثبيت التطبيق
- ينفِّذ المستخدم عملية "محو البيانات" في التطبيق.
- الجهاز غير المستخدَم لفترة طويلة (يحدِّد الجهاز والمنطقة الفترة الزمنية).
- ترصد خدمة معرّف المثيل إساءة الاستخدام أو الأخطاء وتعيد ضبط
InstanceID
- رمز من جهة الخادم إذا كان تطبيق العميل يتطلب هذه الوظيفة.
ترسِل خدمة "رقم تعريف المثيل" إشعارًا إلى التطبيق بإعادة ضبط InstanceID
من خلال
رد الاتصال إلى InstanceIDListenerService
. إذا تلقّى تطبيقك هذه الرسالة
يجب أن يتصل بـ getToken()
ويسترد InstanceID
الجديد،
وتحديث خوادمها.
استخدِم طريقة getToken
لإثبات ملكية InstanceID
والسماح بها.
الوصول إلى البيانات أو الخدمات المرتبطة بالتطبيق. تتبع الطريقة
أنماط OAuth2، وتتطلّب authorizedEntity
وscope
. تشير رسالة الأشكال البيانية
يمكن أن يكون authorizedEntity
رقم تعريف مشروع أو InstanceID
آخر ويحدّده.
الخدمات المسموح لها باستخدام الرمز الذي تم إنشاؤه. scope
الخدمة أو البيانات المحددة التي يسمح الرمز المميز بالوصول إليها.
مزيد من المعلومات حول واجهة Instance ID API الخاصة بما يلي: