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 Developers 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