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