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