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