chrome.instanceID

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

gcm

مدى التوفّر

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

الطُرق

deleteID()

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

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

المعلمات

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

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

deleteToken()

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

لإبطال رمز مميّز تم منحه

المعلمات

  • deleteTokenParams

    عنصر

    مَعلمات deleteToken.

    • authorizedEntity

      سلسلة

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

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

    • نطاق

      سلسلة

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

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

  • callback

    function اختياري

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

    () => void

المرتجعات

  • وعد<فراغ>

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

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

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

getCreationTime()

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

يستردّ وقت إنشاء InstanceID. سيتم عرض وقت الإنشاء من خلال callback.

المعلمات

  • callback

    function اختياري

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

    (creationTime: number) => void

    • creationTime

      الرقم

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

المرتجعات

  • <number>

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

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

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

getID()

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

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

المعلمات

  • callback

    function اختياري

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

    (instanceID: string) => void

    • instanceID

      سلسلة

      رقم تعريف مثيل تم تعيينه لمثيل التطبيق.

المرتجعات

  • وعد<سلسلة>

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

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

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

getToken()

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

يتم عرض رمز مميّز يسمح للجهة المرخّص لها بالوصول إلى الخدمة المحدّدة حسب النطاق.

المعلمات

  • getTokenParams

    عنصر

    المَعلمات الخاصة بـ getToken.

    • authorizedEntity

      سلسلة

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

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

    • الخيارات

      object اختياري

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

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

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

    • نطاق

      سلسلة

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

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

  • callback

    function اختياري

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

    (token: string) => void

    • رمز مميز

      سلسلة

      رمز مميّز تم تعيينه من خلال الخدمة المطلوبة

المرتجعات

  • وعد<سلسلة>

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

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

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

الفعاليات

onTokenRefresh

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

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

المعلمات

  • callback

    دالة

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

    () => void