chrome.instanceID

الوصف

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

الأذونات

gcm

مدى التوفّر

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

الطُرق

deleteID()

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

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

المرتجعات

  • Promise<void>

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

deleteToken()

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

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

المعلمات

  • deleteTokenParams

    عنصر

    مَعلمات deleteToken

    • authorizedEntity

      سلسلة

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

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

    • نطاق

      سلسلة

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

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

المرتجعات

  • Promise<void>

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

getCreationTime()

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

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

المرتجعات

  • Promise<number>

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

getID()

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

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

المرتجعات

  • Promise<string>

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

getToken()

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

عرض رمز مميّز يتيح للكيان المفوَّض الوصول إلى الخدمة المحدّدة حسب النطاق

المعلمات

  • getTokenParams

    عنصر

    مَعلمات getToken

    • authorizedEntity

      سلسلة

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

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

    • الخيارات

      العنصر اختياري

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

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

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

    • نطاق

      سلسلة

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

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

المرتجعات

  • Promise<string>

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

الفعاليات

onTokenRefresh

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

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

المعلمات

  • callback

    دالة

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

    () => void