لاستخدام معظم ميزات Chrome* يجب أن توضّح واجهات برمجة التطبيقات أو الإضافة أو التطبيق الغرض من استخدامها في حقل "الأذونات" في manifest. يمكن أن يكون كل إذن إما سلسلة ضمن قائمة من السلاسل المعروفة (مثل "geolocation") أو نمط مطابقة يسمح بالوصول إلى مضيف واحد أو أكثر. تساعد الأذونات في الحد من الضرر في حال اختراق إضافة أو تطبيقك من خلال برامج ضارة. يتم أيضًا عرض بعض الأذونات للمستخدمين قبل التثبيت، كما هو موضّح بالتفصيل في تحذيرات الأذونات.
إذا كانت واجهة برمجة التطبيقات تتطلّب منك الإفصاح عن إذن في البيان، ستوضّح لك مستنداتها كيفية إجراء ذلك. على سبيل المثال، توضّح لك صفحة مساحة التخزين كيفية الإفصاح عن إذن "مساحة التخزين".
في ما يلي مثال على جزء الأذونات في ملف البيان:
"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 بالوصول إلى واجهة برمجة التطبيقات chrome.certificateProvider. |
"clipboardRead" |
مطلوبة إذا كانت الإضافة أو التطبيق يستخدمان document.execCommand('paste'). |
"clipboardWrite" |
يشير إلى أنّ الإضافة أو التطبيق يستخدمان document.execCommand('copy') أو
document.execCommand('cut'). هذا الإذن مطلوب للتطبيقات المستضافة، ويُنصح باستخدامه
للإضافات والتطبيقات المُجمَّعة. |
"contentSettings" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.contentSettings. |
"contextMenus" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.contextMenus. |
"cookies" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.cookies. |
"debugger" |
يمنح هذا الإذن إضافة Chrome إذن الوصول إلى واجهة برمجة التطبيقات chrome.debugger. |
"declarativeContent" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.declarativeContent. |
"declarativeNetRequest" |
منح إضافة Chrome إذن الوصول إلى واجهة برمجة التطبيقات 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 إمكانية الوصول إلى واجهة برمجة التطبيقات chrome.enterprise.networkingAttributes. |
"enterprise.platformKeys" |
منح إضافة Chrome إذن الوصول إلى واجهة برمجة التطبيقات chrome.enterprise.platformKeys |
"experimental" |
مطلوبة إذا كانت الإضافة أو التطبيق يستخدمان أي chrome.experimental.* واجهات برمجة التطبيقات |
"fileBrowserHandler" |
يمنح هذه الإضافة إذن الوصول إلى واجهة برمجة التطبيقات chrome.fileBrowserHandler. |
"fileSystemProvider" |
تمنح هذه الإذن لإضافة إمكانية الوصول إلى واجهة برمجة التطبيقات chrome.fileSystemProvider. |
"fontSettings" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.fontSettings. |
"gcm" |
يمنح هذه الإضافة إذن الوصول إلى واجهة برمجة التطبيقات chrome.gcm. |
"geolocation" |
السماح للإضافة أو التطبيق باستخدام واجهة برمجة التطبيقات لتحديد الموقع الجغرافي بدون طلب الإذن من المستخدم |
"history" |
يمنح هذا الإذن إضافة Chrome إذن الوصول إلى واجهة برمجة التطبيقات chrome.history. |
"identity" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.identity. |
"idle" |
يمنح هذا الإذن إضافتك إمكانية الوصول إلى واجهة برمجة التطبيقات chrome.idle. |
"loginState" |
منح إضافة Chrome إذن الوصول إلى واجهة برمجة التطبيقات chrome.loginState |
"management" |
يمنح هذا الإذن إضافة Chrome إمكانية الوصول إلى واجهة برمجة التطبيقات chrome.management. |
"nativeMessaging" |
يمنح هذا الإذن إضافة التطبيق إمكانية الوصول إلى واجهة برمجة التطبيقات المخصّصة للرسائل. |
"notifications" |
منح إضافة Chrome إذن الوصول إلى واجهة برمجة التطبيقات chrome.notifications |
"pageCapture" |
منح إضافة Chrome إذن الوصول إلى واجهة برمجة التطبيقات chrome.pageCapture |
"platformKeys" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.platformKeys. |
"power" |
يمنح هذه الإضافة إذن الوصول إلى واجهة برمجة التطبيقات chrome.power. |
"printerProvider" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.printerProvider. |
"printing" |
منح إضافة Chrome إذن الوصول إلى واجهة برمجة التطبيقات chrome.printing |
"printingMetrics" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.printingMetrics. |
"privacy" |
منح إضافة Chrome إذن الوصول إلى واجهة برمجة التطبيقات chrome.privacy |
"processes" |
يمنح هذا الإذن إضافة Chrome إمكانية الوصول إلى واجهة برمجة التطبيقات chrome.processes. |
"proxy" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.proxy. |
"scripting" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.scripting. |
"search" |
منح إضافة Chrome إذن الوصول إلى واجهة برمجة التطبيقات chrome.search |
"sessions" |
يمنح هذه الإضافة إذن الوصول إلى واجهة برمجة التطبيقات chrome.sessions. |
"signedInDevices" |
منح إضافة Chrome إذن الوصول إلى واجهة برمجة التطبيقات chrome.signedInDevices |
"storage" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.storage. |
"system.cpu" |
يمنح هذه الإضافة إذن الوصول إلى واجهة برمجة التطبيقات chrome.system.cpu. |
"system.display" |
يمنح هذا الإذن إضافة Chrome إمكانية الوصول إلى واجهة برمجة التطبيقات 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 إذن الوصول إلى واجهة برمجة التطبيقات chrome.topSites. |
"tts" |
منح إضافة Chrome إذن الوصول إلى واجهة برمجة التطبيقات chrome.tts |
"ttsEngine" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.ttsEngine. |
"unlimitedStorage" |
يوفّر حصة غير محدودة لتخزين البيانات من جهة العميل، مثل قواعد البيانات وملفات التخزين على الجهاز.
في حال عدم منح هذا الإذن، تقتصر مساحة التخزين المتوفّرة للإضافة أو التطبيق على 5 ميغابايت. ملاحظة: لا ينطبق هذا الإذن إلا على قاعدة بيانات لغة الاستعلامات البنيوية (SQL) على الإنترنت وذاكرة التخزين المؤقت للتطبيق
(راجِع المشكلة 58985). ولا تعمل هذه الميزة حاليًا مع النطاقات الفرعية
التي تحتوي على العلامة النائبة، مثل
http://*.example.com. |
"vpnProvider" |
منح إضافة Chrome إذن الوصول إلى واجهة برمجة التطبيقات chrome.vpnProvider |
"wallpaper" |
يمنح هذه الإضافة إذن الوصول إلى واجهة برمجة التطبيقات chrome.wallpaper. |
"webNavigation" |
تمنح هذه الإذن إضافة Chrome بالوصول إلى واجهة برمجة التطبيقات chrome.webNavigation. |
"webRequest" |
يمنح هذا الإذن إضافتك إذن الوصول إلى واجهة برمجة التطبيقات chrome.webRequest. |
"webRequestBlocking" |
مطلوب إذا كانت الإضافة تستخدم واجهة برمجة التطبيقات chrome.webRequest بطريقة حظر. |