browser.instanceID

الوصف

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

الأذونات

gcm

مدى التوفّر

الإصدار 44 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

الطُرق

deleteID()

browser.instanceID.deleteID(): Promise<void>

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

المرتجعات

  • وعد<فراغ>

    الإصدار 96 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

deleteToken()

browser.instanceID.deleteToken(
  deleteTokenParams: object,
): Promise<void>

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

المعلمات

  • deleteTokenParams

    عنصر

    مَعلمات deleteToken.

    • authorizedEntity

      سلسلة

      الإصدار 46 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

    • نطاق

      سلسلة

      الإصدار 46 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

المرتجعات

  • وعد<فراغ>

    الإصدار 96 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

getCreationTime()

browser.instanceID.getCreationTime(): Promise<number>

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

المرتجعات

  • <number>

    الإصدار 96 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

getID()

browser.instanceID.getID(): Promise<string>

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

المرتجعات

  • وعد<سلسلة>

    الإصدار 96 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

getToken()

browser.instanceID.getToken(
  getTokenParams: object,
): Promise<string>

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

المعلمات

  • getTokenParams

    عنصر

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

    • authorizedEntity

      سلسلة

      الإصدار 46 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

    • الخيارات

      object اختياري

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

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

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

    • نطاق

      سلسلة

      الإصدار 46 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

المرتجعات

  • وعد<سلسلة>

    الإصدار 96 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

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

الفعاليات

onTokenRefresh

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

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

المعلمات

  • callback

    دالة

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

    () => void