chrome.instanceID

الوصف

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

الأذونات

gcm

مدى التوفّر

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

الطُرق

deleteID()

وعود 
chrome.instanceID.deleteID(
  callback?: function,
)

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

المعلمات

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

deleteToken()

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

تعمل على إبطال رمز مميز تم منحه.

المعلمات

  • deleteTokenParams

    كائن

    مَعلمات deleteToken

    • authorizedEntity

      سلسلة

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

      يشير هذا المصطلح إلى الكيان المفوَّض الذي يتم استخدامه للحصول على الرمز المميّز.

    • نطاق

      سلسلة

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

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

getCreationTime()

وعود 
chrome.instanceID.getCreationTime(
  callback?: function,
)

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

المعلمات

  • رد الاتصال

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

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

    (creationTime: number) => void

    • creationTime

      الرقم

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

المرتجعات

  • Promise&lt;number&gt;

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

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

getID()

وعود 
chrome.instanceID.getID(
  callback?: function,
)

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

المعلمات

  • رد الاتصال

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

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

    (instanceID: string) => void

    • instanceID

      سلسلة

      رقم تعريف مثيل تم تحديده لمثيل التطبيق

المرتجعات

  • وعود<string>

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

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

getToken()

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

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

المعلمات

  • getTokenParams

    كائن

    مَعلمات getToken.

    • authorizedEntity

      سلسلة

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

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

    • الخيارات

      الكائن اختياري

      الإصدار 46 من Chrome أو الإصدارات الأحدث متوقّف منذ الإصدار 89 من Chrome

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

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

    • نطاق

      سلسلة

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

      يحدِّد الإجراءات المُصرَّح بها التي يمكن للكيان المُصرَّح لها اتخاذها. مثلاً: لإرسال رسائل GCM، يجب استخدام نطاق GCM.

  • رد الاتصال

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

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

    (token: string) => void

    • رمز مميز

      سلسلة

      رمز مميّز معيَّن من خلال الخدمة المطلوبة.

المرتجعات

  • وعود<string>

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

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

فعاليات

onTokenRefresh

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

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

المعلمات

  • رد الاتصال

    دالة

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

    () => void