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