chrome.instanceID

الوصف

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

الأذونات

gcm

مدى التوفّر

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

الطُرق

deleteID()

وعود

chrome.instanceID.deleteID(
  callback?: function,
)

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

المعلمات

• رد الاتصال

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

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

  () => void

المرتجعات

• وعود <باطلة>

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

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

deleteToken()

وعود

chrome.instanceID.deleteToken(
  deleteTokenParams: object,
  callback?: function,
)

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

المعلمات

• deleteTokenParams

  كائن

  مَعلمات deleteToken

  • authorizedEntity

    سلسلة

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

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

  • نطاق

    سلسلة

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

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

• رد الاتصال

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

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

  () => void

المرتجعات

• وعود <باطلة>

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

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

getCreationTime()

وعود

chrome.instanceID.getCreationTime(
  callback?: function,
)

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

المعلمات

• رد الاتصال

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

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

  (creationTime: number) => void

  • creationTime

    الرقم

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

المرتجعات

• Promise&lt;number&gt;

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

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

getID()

وعود

chrome.instanceID.getID(
  callback?: function,
)

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

المعلمات

• رد الاتصال

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

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

  (instanceID: string) => void

  • instanceID

    سلسلة

    رقم تعريف مثيل تم تحديده لمثيل التطبيق

المرتجعات

• وعود<string>

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

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

getToken()

وعود

chrome.instanceID.getToken(
  getTokenParams: object,
  callback?: function,
)

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

المعلمات

• getTokenParams

  كائن

  مَعلمات getToken.

  • authorizedEntity

    سلسلة

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

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

  • الخيارات

    الكائن اختياري

    الإصدار 46 من Chrome أو الإصدارات الأحدث متوقّف منذ الإصدار 89 من Chrome

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

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

  • نطاق

    سلسلة

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

    يحدِّد الإجراءات المُصرَّح بها التي يمكن للكيان المُصرَّح لها اتخاذها. مثلاً: لإرسال رسائل GCM، يجب استخدام نطاق GCM.

• رد الاتصال

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

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

  (token: string) => void

  • رمز مميز

    سلسلة

    رمز مميّز معيَّن من خلال الخدمة المطلوبة.

المرتجعات

• وعود<string>

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

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير معاودة الاتصال. التوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. تشير رسالة الأشكال البيانية يتم حل الوعد بنفس النوع الذي يتم إرساله إلى معاودة الاتصال.

فعاليات

onTokenRefresh

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

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

المعلمات

• رد الاتصال

  دالة

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

  () => void