chrome.instanceID

refresh date: 2026-09-25 robots: noindex

الوصف

استخدِم chrome.instanceID للوصول إلى خدمة "رقم تعريف المثيل".

الأذونات

gcm

مدى التوفّر

Chrome 44 والإصدارات الأحدث

الطُرق

deleteID()

وعد 
chrome.instanceID.deleteID(
  callback?: function,
): Promise<void>

تعيد هذه الطريقة ضبط معرّف مثيل التطبيق وتلغي جميع الرموز المميزة المرتبطة به.

المعلمات

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    ‫Chrome 96 والإصدارات الأحدث

    يتم حلّها عند اكتمال عملية الحذف. تم إبطال معرّف المثيل بنجاح إذا لم يتم رفض الوعد.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

deleteToken()

وعد 
chrome.instanceID.deleteToken(
  deleteTokenParams: object,
  callback?: function,
): Promise<void>

يبطل هذا الإجراء رمزًا مميّزًا تم منحه.

المعلمات

  • deleteTokenParams

    عنصر

    مَعلمات deleteToken

    • authorizedEntity

      سلسلة

      Chrome 46 والإصدارات الأحدث

      الجهة المفوَّضة التي يتم استخدامها للحصول على الرمز المميز

    • نطاق

      سلسلة

      Chrome 46 والإصدارات الأحدث

      النطاق المستخدَم للحصول على الرمز المميّز.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    ‫Chrome 96 والإصدارات الأحدث

    يتم حلّها عند اكتمال عملية حذف الرمز المميز. تم إبطال الرمز المميّز بنجاح إذا لم يتم رفض الوعد.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

getCreationTime()

وعد 
chrome.instanceID.getCreationTime(
  callback?: function,
): Promise<number>

تعرض هذه السمة الوقت الذي تم فيه إنشاء InstanceID. سيتم عرض وقت الإنشاء من خلال callback.

المعلمات

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (creationTime: number) => void

    • creationTime

      الرقم

      الوقت الذي تم فيه إنشاء معرّف المثيل، ويتم تمثيله بالمللي ثانية منذ بدء الحقبة.

المرتجعات

  • Promise<number>

    ‫Chrome 96 والإصدارات الأحدث

    يتم حلّها عند اكتمال عملية الاسترداد.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

getID()

وعد 
chrome.instanceID.getID(
  callback?: function,
): Promise<string>

تعرض هذه السمة معرّفًا لنسخة التطبيق. ستعرض callback رقم تعريف المثيل. سيتم عرض المعرّف نفسه ما دام لم يتم إبطال أو انتهاء صلاحية هوية التطبيق.

المعلمات

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (instanceID: string) => void

    • instanceID

      سلسلة

      رقم تعريف النسخة الافتراضية للتطبيق

المرتجعات

  • Promise<string>

    ‫Chrome 96 والإصدارات الأحدث

    يتم حلّها عند اكتمال عملية الاسترداد.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

getToken()

وعد 
chrome.instanceID.getToken(
  getTokenParams: object,
  callback?: function,
): Promise<string>

عرض رمز مميز يتيح للكيان المفوَّض الوصول إلى الخدمة المحدّدة حسب النطاق

المعلمات

  • getTokenParams

    عنصر

    مَعلمات getToken

    • authorizedEntity

      سلسلة

      Chrome 46 والإصدارات الأحدث

      تحدّد هذه السمة الكيان المصرَّح له بالوصول إلى الموارد المرتبطة برقم تعريف المثيل هذا. يمكن أن يكون رقم تعريف مشروع من Google Developer Console.

    • الخيارات

      كائن اختياري

      الإصدار 46 من Chrome والإصدارات الأحدث تم إيقافها نهائيًا منذ الإصدار 89 من Chrome

      تم إيقاف الخيارات نهائيًا وسيتم تجاهلها.

      تسمح بتضمين عدد صغير من أزواج المفتاح/القيمة النصية التي سيتم ربطها بالرمز المميّز ويمكن استخدامها في معالجة الطلب.

    • نطاق

      سلسلة

      Chrome 46 والإصدارات الأحدث

      تحدّد هذه السمة الإجراءات المسموح بها التي يمكن للكيان المفوَّض اتّخاذها. على سبيل المثال، لإرسال رسائل GCM، يجب استخدام النطاق GCM.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (token: string) => void

    • الرمز المميّز

      سلسلة

      رمز مميز تمنحه الخدمة المطلوبة.

المرتجعات

  • Promise<string>

    ‫Chrome 96 والإصدارات الأحدث

    يتم حلّها عند اكتمال عملية الاسترداد.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

الفعاليات

onTokenRefresh

chrome.instanceID.onTokenRefresh.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عندما تحتاج جميع الرموز المميزة الممنوحة إلى إعادة تحميل.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    () => void