واجهة برمجة تطبيقات معرّف المثيل
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك واجهة برمجة التطبيقات لمعرّف المثيل دمج معرّف المثيل مع تطبيق Android أو iOS. يوفّر معرّف المثيل معرّفًا فريدًا لكل مثيل من تطبيقك وآلية لمصادقة الإجراءات ومنح الإذن بها. InstanceID هو معرّف طويل الأمد، ولكن قد تنتهي صلاحيته للأسباب التالية:
إعادة الضبط على الإعدادات الأصلية للجهاز
إلغاء المستخدم تثبيت التطبيق
تنفيذ المستخدم إجراء "محو البيانات" في التطبيق
عدم استخدام الجهاز لفترة طويلة (يحدّد الجهاز والمنطقة الفترة الزمنية)
رصد خدمة معرّف المثيل إساءة استخدام أو أخطاء وإعادة ضبط InstanceID
رمز من جهة الخادم إذا كان تطبيق العميل يتطلّب هذه الوظيفة
تُعلم خدمة معرّف المثيل تطبيقك بإعادة ضبط InstanceID من خلال
معاودة الاتصال بـ InstanceIDListenerService. إذا تلقّى تطبيقك هذا الإشعار، عليه استدعاء getToken() واسترداد InstanceID الجديد وتعديل خوادمه.
استخدِم طريقة getToken لإثبات ملكية InstanceID والسماح للخوادم بالوصول إلى البيانات أو الخدمات المرتبطة بالتطبيق. تتّبع الطريقة أنماط OAuth2 وتتطلّب authorizedEntity وscope. يمكن أن يكون authorizedEntity رقم تعريف مشروع أو InstanceID آخر، ويحدّد الخدمات المسموح لها باستخدام الرمز المميّز الذي تم إنشاؤه. يحدّد scope الخدمة أو البيانات المحدّدة التي يسمح الرمز المميّز بالوصول إليها.
مزيد من المعلومات عن واجهة برمجة التطبيقات لمعرّف المثيل:
تاريخ التعديل الأخير: 2026-06-18 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2026-06-18 (حسب التوقيت العالمي المتفَّق عليه)"],[],[]]
