chrome.instanceID

الوصف

استخدِم chrome.instanceID للوصول إلى خدمة Instance ID.

الأذونات

gcm

مدى التوفّر

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

الطُرق

deleteID()

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

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

المعلمات

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

deleteToken()

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

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

المعلمات

  • deleteTokenParams

    عنصر

    مَعلمات deleteToken

    • authorizedEntity

      سلسلة

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

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

    • نطاق

      سلسلة

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

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

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

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

getCreationTime()

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

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

المعلمات

  • callback

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

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

    (creationTime: number) => void

    • creationTime

      الرقم

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

المرتجعات

  • Promise<number>

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

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

getID()

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

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

المعلمات

  • callback

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

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

    (instanceID: string) => void

    • instanceID

      سلسلة

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

المرتجعات

  • Promise<string>

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

    لا تتوافق الوعود إلا مع الإصدار 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>

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

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

الفعاليات

onTokenRefresh

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

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

المعلمات

  • callback

    دالة

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

    () => void