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

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

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

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

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

اطّلِع على المزيد من المعلومات عن Instance ID API من أجل:

Android  iOS  الخادم