لاستخدام معظم Chrome.* واجهات برمجة التطبيقات، يجب أن توضّح الإضافة أو التطبيق الغرض منه في "الأذونات" حقل للبيان. يمكن أن يكون كل إذن إما إحدى قوائم السلاسل المعروفة (مثل "الموقع الجغرافي") أو نمط مطابقة يتيح الوصول إلى مضيف واحد أو أكثر. تساعد الأذونات في الحد من الضرر في حال تعرُّض الإضافة أو التطبيق للاختراق من البرامج الضارة. يتم أيضًا عرض بعض الأذونات للمستخدمين قبل التثبيت، كما هو موضح بالتفصيل في تحذيرات الأذونات.
إذا كانت واجهة برمجة التطبيقات تطلب منك تقديم بيان عن إذن في البيان، ستوضّح لك مستنداتها كيفية تنفيذ ذلك. القيام بذلك. على سبيل المثال، تعرض لك صفحة مساحة التخزين كيفية تحديد قيمة "مساحة التخزين". إذن.
في ما يلي مثال على جزء الأذونات في ملف بيان:
"permissions": [
"tabs",
"bookmarks",
"http://www.blogger.com/",
"http://*.google.com/",
"unlimitedStorage"
],
يعرض الجدول التالي الأذونات المتاحة حاليًا:
| الإذن | الوصف |
|---|---|
"activeTab" |
تطلب منح الإضافة أذونات وفقًا لعلامة activeTab. المواصفات. |
"alarms" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.alarms |
"background" |
تعمل هذه الميزة على بدء تشغيل Chrome مبكرًا وإيقافه متأخرًا، حتى تستغرق مدة أطول للتطبيقات والإضافات. حياة. عندما يتم تثبيت "الخلفية" في أي تطبيق مستضاف أو تطبيق مجمّع أو إضافة إذن، يشغِّل Chrome (بشكل غير مرئي) بمجرد تسجيل دخول المستخدم إلى جهاز الكمبيوتر الخاص به - قبل تشغيل المستخدم Chrome. "الخلفية" يؤدي الإذن أيضًا إلى مواصلة تشغيل Chrome (حتى بعد إغلاق نافذته الأخيرة) إلى أن يختار المستخدم صراحةً. لإغلاق Chrome. ملاحظة: يتم التعامل مع التطبيقات والإضافات التي تم إيقافها كما لو لم يتم التعامل معها.
مثبت.
أنت تستخدم عادةً "الخلفية" إذن باستخدام صفحة خلفية أو صفحة حدث أو (بالنسبة إلى التطبيقات المستضافة) نافذة خلفية. |
"bookmarks" |
لمنح الإضافة إذنًا بالوصول إلى واجهة برمجة تطبيقات chrome.bookmarks. |
"browsingData" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.browsingData. |
"certificateProvider" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.certificateProvider. |
"clipboardRead" |
مطلوبة إذا كانت الإضافة أو التطبيق تستخدم document.execCommand('paste'). |
"clipboardWrite" |
يشير إلى أن الإضافة أو التطبيق يستخدم document.execCommand('copy') أو
document.execCommand('cut') هذا الإذن مطلوب للتطبيقات المستضافة. بَنْصَحْ
للإضافات والتطبيقات المجمّعة. |
"contentSettings" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.contentSettings |
"contextMenus" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.contextMenus. |
"cookies" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.cookies. |
"debugger" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.debugger. |
"declarativeContent" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.declarativeContent. |
"declarativeNetRequest" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.declarativeNetRequest |
"declarativeNetRequestFeedback" |
يمنح الإضافة إمكانية الوصول إلى الأحداث والطرق ضمن واجهة برمجة تطبيقات chrome.declarativeNetRequest التي تعرض معلومات عن البيانات التعريفية. قواعد متطابقة. |
"declarativeWebRequest" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.declarativeWebRequest. |
"desktopCapture" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.desktopCapture. |
"documentScan" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.documentScan |
"downloads" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.downloads. |
"enterprise.deviceAttributes" |
يمنح هذا الإعداد الإضافة إمكانية الوصول إلى واجهة برمجة التطبيقات chrome.enterprise.deviceAttributes. |
"enterprise.hardwarePlatform" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.enterprise.hardwarePlatform. |
"enterprise.networkingAttributes" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة التطبيقات chrome.enterprise.networkingAttributes. |
"enterprise.platformKeys" |
لمنح الإضافة إذنًا بالوصول إلى واجهة برمجة تطبيقات chrome.enterprise.platformKeys |
"experimental" |
مطلوبة إذا كانت الإضافة أو التطبيق تستخدم أيًا من chrome.experimental.* API. |
"fileBrowserHandler" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.fileBrowserHandler. |
"fileSystemProvider" |
لمنح الإضافة إذنًا بالوصول إلى واجهة برمجة تطبيقات chrome.fileSystemProvider |
"fontSettings" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.fontSettings |
"gcm" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.gcm. |
"geolocation" |
السماح للإضافة أو التطبيق باستخدام geolocation API بدون طلب من المستخدم إذن. |
"history" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.history. |
"identity" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.identity. |
"idle" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.idle. |
"loginState" |
لمنح الإضافة إذنًا بالوصول إلى واجهة برمجة تطبيقات chrome.loginState. |
"management" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.management |
"nativeMessaging" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات المراسلة مع التطبيقات الأصلية. |
"notifications" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.notifications. |
"pageCapture" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.pageCapture. |
"platformKeys" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.platformKeys |
"power" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.power |
"printerProvider" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.printerProvider |
"printing" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.printing. |
"printingMetrics" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.printingMetrics. |
"privacy" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.privacy. |
"processes" |
لمنح الإضافة إذنًا بالوصول إلى واجهة برمجة تطبيقات chrome.processes |
"proxy" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.proxy. |
"scripting" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.scripting. |
"search" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.search |
"sessions" |
لمنح الإضافة إذنًا بالوصول إلى واجهة برمجة تطبيقات chrome.sessions |
"signedInDevices" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة التطبيقات chrome.signedInDevices. |
"storage" |
لمنح الإضافة إذنًا بالوصول إلى واجهة برمجة تطبيقات chrome.storage. |
"system.cpu" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.system.cpu. |
"system.display" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.system.display. |
"system.memory" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة التطبيقات chrome.system.memory. |
"system.storage" |
لمنح الإضافة إذنًا بالوصول إلى واجهة برمجة تطبيقات chrome.system.storage. |
"tabCapture" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.tabCapture. |
"tabGroups" |
لمنح الإضافة إذنًا بالوصول إلى واجهة برمجة تطبيقات chrome.tabGroups. |
"tabs" |
يمنح الإضافة إمكانية الوصول إلى الحقول المميزة لكائنات Tab التي تستخدمها العديد من واجهات برمجة التطبيقات.
بما في ذلك chrome.tabs وchrome.windows. ضِمن
العديد من الحالات التي لن تحتاج فيها الإضافة إلى تقديم بيان عن إذن ""tabs"" للاستفادة من
لواجهات برمجة التطبيقات هذه. |
"topSites" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.topSites. |
"tts" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.tts. |
"ttsEngine" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.ttsEngine. |
"unlimitedStorage" |
توفر حصة غير محدودة لتخزين البيانات من جهة العميل، مثل قواعد البيانات وملفات التخزين المحلية.
وبدون هذا الإذن، تقتصر الإضافة أو التطبيق على 5 ميغابايت من مساحة التخزين المحلية. ملاحظة: ينطبق هذا الإذن فقط على قاعدة بيانات لغة الاستعلامات البنيوية (SQL) على الويب وذاكرة التخزين المؤقت للتطبيق
(اطّلِع على المشكلة رقم 58985). ولا يمكن استخدام أحرف البدل حاليًا.
نطاقات فرعية مثل
http://*.example.com. |
"vpnProvider" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.vpnProvider |
"wallpaper" |
يمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.wallpaper. |
"webNavigation" |
لمنح الإضافة إمكانية الدخول إلى واجهة برمجة تطبيقات chrome.webNavigation. |
"webRequest" |
لمنح الإضافة إمكانية الوصول إلى واجهة برمجة تطبيقات chrome.webRequest. |
"webRequestBlocking" |
مطلوبة إذا كانت الإضافة تستخدم واجهة برمجة التطبيقات chrome.webRequest بطريقة حظر. |