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