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