chrome.instanceID

الوصف

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

الأذونات

gcm

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

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

الطُرق

deleteID()

وعد 
chrome.instanceID.deleteID(
  callback?: function,
)

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

المَعلمات

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

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

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

    ()=>void

المرتجعات

  • Promise<void>

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

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

deleteToken()

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

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

المَعلمات

  • deleteTokenParams

    كائن

    معلَمات deleteToken.

    • authorizedEntity

      سلسلة

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

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

    • نطاق

      سلسلة

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

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

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

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

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

    ()=>void

المرتجعات

  • Promise<void>

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

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

getCreationTime()

وعد 
chrome.instanceID.getCreationTime(
  callback?: function,
)

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

المَعلمات

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

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

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

    (creationTime: number)=>void

    • creationTime

      الرقم

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

المرتجعات

  • وعد<الرقم>

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

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

getID()

وعد 
chrome.instanceID.getID(
  callback?: function,
)

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

المَعلمات

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

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

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

    (instanceID: string)=>void

    • instanceID

      سلسلة

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

المرتجعات

  • وعد<string>

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

    تتوفّر الوعود في إصدار 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 والإصدارات الأحدث

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

فعاليات

onTokenRefresh

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

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

المَعلمات

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

    الوظيفة

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

    ()=>void