chrome.instanceID

الوصف

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

الأذونات

gcm

مدى توفّر الخدمة

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

الطُرق

deleteID()

وعد

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

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

المَعلمات

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

deleteToken()

وعد

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

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

المَعلمات

• deleteTokenParams

  كائن

  معلَمات deleteToken.

  • authorizedEntity

    سلسلة

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

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

  • نطاق

    سلسلة

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

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

getCreationTime()

وعد

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

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

المَعلمات

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (creationTime: number)=>void

  • creationTime

    الرقم

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

المرتجعات

• وعد<الرقم>

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

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

getID()

وعد

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

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

المَعلمات

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (instanceID: string)=>void

  • instanceID

    سلسلة

    رقم تعريف مثيل تم تخصيصه لمثيل التطبيق.

المرتجعات

• وعد<string>

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

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

getToken()

وعد

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

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

المَعلمات

• getTokenParams

  كائن

  معلَمات getToken.

  • authorizedEntity

    سلسلة

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

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

  • الخيارات

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

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

    متوقفة نهائيًا وسيتم تجاهلها.

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

  • نطاق

    سلسلة

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

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (token: string)=>void

  • رمز مميّز

    سلسلة

    رمز مميز مخصّص من قِبل الخدمة المطلوبة.

المرتجعات

• وعد<string>

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

  لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.

فعاليات

onTokenRefresh

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

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

المَعلمات

• معاودة الاتصال

  الوظيفة

  تبدو معلَمة callback على النحو التالي:

  ()=>void