الوصف
استخدِم "chrome.instanceID
" للوصول إلى خدمة "معرّف المثيل".
الأذونات
gcm
مدى توفّر الخدمة
الطُرق
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