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

    • الخيارات

      عنصر اختياري

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

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

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

    • نطاق

      سلسلة

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

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

المرتجعات

  • Promise<string>

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

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

الفعاليات

onTokenRefresh

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

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

المعلمات

  • callback

    دالة

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

    () => void