واجهة برمجة تطبيقات معرّف المثيل

تتيح لك واجهة Instance ID API دمج Instance ID مع جهاز Android أو تطبيق iOS. يوفر رقم تعريف المثيل معرفًا فريدًا لكل مثيل تطبيقك وآلية للمصادقة على الإجراءات والسماح بها إنّ InstanceID طويل. ولكنها قد تنتهي صلاحيتها للأسباب التالية:

  • تمت إعادة ضبط الجهاز على الإعدادات الأصلية.
  • يلغي المستخدم تثبيت التطبيق
  • ينفِّذ المستخدم عملية "محو البيانات" في التطبيق.
  • الجهاز غير المستخدَم لفترة طويلة (يحدِّد الجهاز والمنطقة الفترة الزمنية).
  • ترصد خدمة معرّف المثيل إساءة الاستخدام أو الأخطاء وتعيد ضبط InstanceID
  • رمز من جهة الخادم إذا كان تطبيق العميل يتطلب هذه الوظيفة.

ترسِل خدمة "رقم تعريف المثيل" إشعارًا إلى التطبيق بإعادة ضبط InstanceID من خلال رد الاتصال إلى InstanceIDListenerService. إذا تلقّى تطبيقك هذه الرسالة يجب أن يتصل بـ getToken() ويسترد InstanceID الجديد، وتحديث خوادمها.

يمكنك استخدام طريقة getToken لإثبات ملكية InstanceID والسماح بها. الوصول إلى البيانات أو الخدمات المرتبطة بالتطبيق. تتبع الطريقة أنماط OAuth2، وتتطلّب authorizedEntity وscope. تشير رسالة الأشكال البيانية يمكن أن يكون authorizedEntity رقم تعريف مشروع أو InstanceID آخر ويحدّده. الخدمات المسموح لها باستخدام الرمز الذي تم إنشاؤه. scope الخدمة أو البيانات المحددة التي يسمح الرمز المميز بالوصول إليها.

مزيد من المعلومات حول واجهة Instance ID API الخاصة بما يلي:

جهاز Android iOS الخادم