تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك واجهة برمجة التطبيقات 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 في ما يلي:
تاريخ التعديل الأخير: 2025-03-11 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2025-03-11 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The Instance ID API provides a unique identifier for each app instance and enables authentication and authorization."],["Instance IDs are long-lived but can expire due to various factors like device reset, uninstallation, data clearing, extended inactivity, or service-detected issues."],["Upon Instance ID reset, apps are notified and must retrieve a new ID using `getToken()` and update their servers."],["The `getToken()` method, using OAuth2 patterns, verifies Instance ID ownership and grants server access to associated data or services based on authorized entity and scope."]]],[]]
