تمت إزالة إضافات Manifest V2 من "سوق Chrome الإلكتروني" في 31 أغسطس 2026. يجب نقل الإضافة إلى الإصدار Manifest V3 لإتاحتها للمستخدمين مرة أخرى.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

مرجع واجهة برمجة التطبيقات

refresh date: 2026-09-25 robots: noindex

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

accessibilityFeatures: استخدِم واجهة برمجة التطبيقات chrome.accessibilityFeatures لإدارة ميزات تسهيل الاستخدام في Chrome. تعتمد واجهة برمجة التطبيقات هذه على نموذج ChromeSetting الأوّلي لواجهة برمجة التطبيقات من النوع API للحصول على ميزات تسهيل الاستخدام الفردية وضبطها. للحصول على حالات الميزات، يجب أن تطلب الإضافة إذن accessibilityFeatures.read. لتعديل حالة الميزة، تحتاج الإضافة إلى إذن accessibilityFeatures.modify. يُرجى العِلم أنّ accessibilityFeatures.modify لا يعني الحصول على إذن accessibilityFeatures.read.
alarms: استخدِم واجهة برمجة التطبيقات chrome.alarms لجدولة الرمز البرمجي ليتم تنفيذه بشكل دوري أو في وقت محدّد في المستقبل.
audio: الإصدار 59 من Chrome أو الإصدارات الأحدث نظام التشغيل ChromeOS فقط

يتم توفير واجهة برمجة التطبيقات chrome.audio للسماح للمستخدمين بالحصول على معلومات حول أجهزة الصوت المتصلة بالنظام والتحكّم فيها. لا تتوفّر واجهة برمجة التطبيقات هذه حاليًا إلا في "وضع Kiosk" على ChromeOS.
الإشارات المرجعية: استخدِم واجهة برمجة التطبيقات chrome.bookmarks لإنشاء الإشارات المرجعية وتنظيمها والتعامل معها بطرق أخرى. يمكنك أيضًا الاطّلاع على صفحات التجاوز التي يمكنك استخدامها لإنشاء صفحة مخصّصة في "إدارة الإشارات المرجعية".
browserAction: &leq; MV2

استخدِم إجراءات المتصفّح لوضع الرموز في شريط أدوات Google Chrome الرئيسي على يسار شريط العناوين. بالإضافة إلى الرمز، يمكن أن يتضمّن إجراء المتصفّح تلميحًا وشارة ونافذة منبثقة.
browsingData: استخدِم واجهة برمجة التطبيقات chrome.browsingData لإزالة بيانات التصفّح من الملف الشخصي المحلّي للمستخدم.
certificateProvider: الإصدار 46 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط

استخدِم واجهة برمجة التطبيقات هذه لعرض الشهادات على النظام الأساسي الذي يمكنه استخدام هذه الشهادات للمصادقة على بروتوكول أمان طبقة النقل (TLS).
الأوامر: استخدِم واجهة برمجة التطبيقات Commands لإضافة اختصارات لوحة المفاتيح التي تؤدي إلى تنفيذ إجراءات في الإضافة، مثل إجراء لفتح إجراء المتصفّح أو إرسال أمر إلى الإضافة.
contentSettings: استخدِم واجهة برمجة التطبيقات chrome.contentSettings لتغيير الإعدادات التي تتحكّم في ما إذا كان بإمكان المواقع الإلكترونية استخدام ميزات مثل ملفات تعريف الارتباط وJavaScript والمكوّنات الإضافية. بشكل عام، تتيح لك إعدادات المحتوى تخصيص سلوك Chrome على أساس كل موقع إلكتروني على حدة بدلاً من تخصيصه على مستوى العالم.
contextMenus: استخدِم واجهة برمجة التطبيقات chrome.contextMenus لإضافة عناصر إلى قائمة السياق في Google Chrome. يمكنك اختيار أنواع العناصر التي تنطبق عليها الإضافات في قائمة السياق، مثل الصور والارتباطات التشعبية والصفحات.
ملفات تعريف الارتباط: استخدِم واجهة برمجة التطبيقات chrome.cookies للاستعلام عن ملفات تعريف الارتباط وتعديلها، ولتلقّي إشعارات عند تغييرها.
debugger: تعمل واجهة برمجة التطبيقات chrome.debugger كبروتوكول نقل بديل لبروتوكول تصحيح الأخطاء عن بُعد في Chrome. استخدِم chrome.debugger للربط بعلامة تبويب واحدة أو أكثر من أجل تسجيل تفاعلات الشبكة وتصحيح أخطاء JavaScript وتعديل DOM وCSS وغير ذلك. استخدِم السمة Debuggee tabId لاستهداف علامات التبويب التي تتضمّن sendCommand وتوجيه الأحداث حسب tabId من عمليات معاودة الاتصال onEvent.
declarativeContent: استخدِم واجهة برمجة التطبيقات chrome.declarativeContent لاتّخاذ إجراءات استنادًا إلى محتوى الصفحة، بدون الحاجة إلى إذن بقراءة محتوى الصفحة.
declarativeNetRequest: ‫Chrome 84 والإصدارات الأحدث

يتم استخدام واجهة برمجة التطبيقات chrome.declarativeNetRequest لحظر طلبات الشبكة أو تعديلها من خلال تحديد قواعد تعريفية. يتيح ذلك للإضافات تعديل طلبات الشبكة بدون اعتراضها والاطّلاع على محتواها، ما يوفّر المزيد من الخصوصية.
declarativeWebRequest: القناة التجريبية &leq; MV2

ملاحظة: تم إيقاف واجهة برمجة التطبيقات هذه نهائيًا. يمكنك الاطّلاع على واجهة برمجة التطبيقات declarativeNetRequest بدلاً من ذلك. استخدِم واجهة برمجة التطبيقات chrome.declarativeWebRequest لاعتراض الطلبات أو حظرها أو تعديلها أثناء نقلها. وهي أسرع بكثير من واجهة برمجة التطبيقات chrome.webRequest لأنّه يمكنك تسجيل قواعد يتم تقييمها في المتصفّح بدلاً من محرّك JavaScript، ما يقلّل من أوقات الاستجابة ويسمح بتحقيق كفاءة أعلى.
desktopCapture: تتيح واجهة برمجة التطبيقات Desktop Capture API التقاط محتوى الشاشة أو النوافذ الفردية أو علامات التبويب الفردية.
devtools.inspectedWindow: استخدِم واجهة برمجة التطبيقات chrome.devtools.inspectedWindow للتفاعل مع النافذة التي تم فحصها: احصل على رقم تعريف علامة التبويب للصفحة التي تم فحصها، أو قيِّم الرمز في سياق النافذة التي تم فحصها، أو أعِد تحميل الصفحة، أو احصل على قائمة الموارد داخل الصفحة.
devtools.network: استخدِم واجهة برمجة التطبيقات chrome.devtools.network لاسترداد المعلومات حول طلبات الشبكة التي تعرضها "أدوات المطوّرين" في لوحة "الشبكة".
devtools.panels: استخدِم واجهة برمجة التطبيقات chrome.devtools.panels لدمج الإضافة في واجهة مستخدم نافذة "أدوات المطوّرين": يمكنك إنشاء لوحاتك الخاصة والوصول إلى اللوحات الحالية وإضافة أشرطة جانبية.
devtools.performance: ‫Chrome 129 والإصدارات الأحدث

استخدِم واجهة برمجة التطبيقات chrome.devtools.performance للاستماع إلى آخر المعلومات عن حالة التسجيل في لوحة "الأداء" ضمن "أدوات مطوّري البرامج".
devtools.recorder: ‫Chrome 105 والإصدارات الأحدث

استخدِم واجهة برمجة التطبيقات chrome.devtools.recorder لتخصيص لوحة Recorder في "أدوات مطوّري البرامج".
dns: قناة مطوري البرامج

استخدِم واجهة برمجة التطبيقات chrome.dns لحلّ نظام أسماء النطاقات.
documentScan: الإصدار 44 من Chrome أو الإصدارات الأحدث نظام التشغيل ChromeOS فقط

استخدِم واجهة برمجة التطبيقات chrome.documentScan للعثور على الصور واستردادها من الماسحات الضوئية للمستندات المرفقة.
dom: الإصدار 88 من Chrome والإصدارات الأحدث

استخدام واجهة برمجة التطبيقات chrome.dom للوصول إلى واجهات برمجة تطبيقات DOM الخاصة بالإضافات
عمليات التنزيل: استخدِم واجهة برمجة التطبيقات chrome.downloads لبدء عمليات التنزيل ومراقبتها وتعديلها والبحث عنها بشكل آلي.
enterprise.deviceAttributes: الإصدار 46 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط يتطلّب سياسة

استخدِم واجهة برمجة التطبيقات chrome.enterprise.deviceAttributes لقراءة سمات الجهاز. ملاحظة: لا تتوفّر واجهة برمجة التطبيقات هذه إلا للإضافات التي تم فرض تثبيتها بموجب سياسة المؤسسة.
enterprise.hardwarePlatform: الإصدار 71 من Chrome والإصدارات الأحدث يتطلّب سياسة

استخدِم واجهة برمجة التطبيقات chrome.enterprise.hardwarePlatform للحصول على الشركة المصنّعة والطراز لمنصة الأجهزة التي يعمل عليها المتصفّح. ملاحظة: لا تتوفّر واجهة برمجة التطبيقات هذه إلا للإضافات التي تم تثبيتها بموجب سياسة المؤسسة.
enterprise.login: الإصدار 139 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط يتطلّب سياسة

استخدِم واجهة برمجة التطبيقات chrome.enterprise.login للخروج من جلسات الضيف المُدارة. ملاحظة: لا تتوفّر واجهة برمجة التطبيقات هذه إلا للإضافات التي تم تثبيتها بموجب سياسة المؤسسة في جلسات الضيف المُدارة على ChromeOS.
enterprise.networkingAttributes: الإصدار 85 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط مطلوب سياسة

استخدِم واجهة برمجة التطبيقات chrome.enterprise.networkingAttributes لقراءة معلومات حول شبكتك الحالية. ملاحظة: لا تتوفّر واجهة برمجة التطبيقات هذه إلا للإضافات التي تم فرض تثبيتها بموجب سياسة المؤسسة.
enterprise.platformKeys: نظام التشغيل ChromeOS فقط تتطلّب سياسة

استخدِم واجهة برمجة التطبيقات chrome.enterprise.platformKeys لإنشاء مفاتيح وتثبيت شهادات لهذه المفاتيح. سيدير النظام الأساسي الشهادات ويمكن استخدامها لمصادقة بروتوكول أمان طبقة النقل (TLS) أو الوصول إلى الشبكة أو بواسطة إضافة أخرى من خلال chrome.platformKeys.
الأحداث: يحتوي الاسم chrome.events على أنواع شائعة تستخدمها واجهات برمجة التطبيقات لإرسال الأحداث لإعلامك عند حدوث شيء مهم.
extension: تحتوي واجهة برمجة التطبيقات chrome.extension على أدوات مساعدة يمكن استخدامها من خلال أي صفحة إضافة. يتضمّن هذا النوع إمكانية تبادل الرسائل بين إضافة وبرامجها النصية الخاصة بالمحتوى أو بين الإضافات، كما هو موضّح بالتفصيل في تمرير الرسائل.
extensionTypes: تحتوي واجهة برمجة التطبيقات chrome.extensionTypes على تعريفات أنواع لإضافات Chrome.
fileBrowserHandler: نظام التشغيل ChromeOS فقط في المقدّمة فقط

استخدِم واجهة برمجة التطبيقات chrome.fileBrowserHandler لتوسيع نطاق متصفّح الملفات في ChromeOS. على سبيل المثال، يمكنك استخدام واجهة برمجة التطبيقات هذه للسماح للمستخدمين بتحميل الملفات إلى موقعك الإلكتروني.
fileSystemProvider: نظام التشغيل ChromeOS فقط

استخدِم واجهة برمجة التطبيقات chrome.fileSystemProvider لإنشاء أنظمة ملفات يمكن الوصول إليها من مدير الملفات على نظام التشغيل ChromeOS.
fontSettings: استخدِم واجهة برمجة التطبيقات chrome.fontSettings لإدارة إعدادات الخط في Chrome.
gcm: استخدِم chrome.gcm للسماح للتطبيقات والإضافات بإرسال الرسائل وتلقّيها من خلال مراسلة Firebase السحابية (FCM).
السجلّ: استخدِم واجهة برمجة التطبيقات chrome.history للتفاعل مع سجلّ الصفحات التي تمت زيارتها في المتصفّح. يمكنك إضافة عناوين URL وإزالتها والبحث عنها في سجلّ المتصفّح. لإلغاء صفحة السجلّ واستخدام نسختك الخاصة، يُرجى الاطّلاع على إلغاء الصفحات.
i18n: استخدِم البنية الأساسية chrome.i18n لتنفيذ عملية التدويل في تطبيقك أو إضافتك بالكامل.
identity: استخدِم واجهة برمجة التطبيقات chrome.identity للحصول على رموز الدخول OAuth2.
idle: استخدِم واجهة برمجة التطبيقات chrome.idle لرصد التغيّرات في حالة عدم النشاط على الجهاز.
input.ime: نظام التشغيل ChromeOS فقط

استخدِم واجهة برمجة التطبيقات chrome.input.ime لتنفيذ محرر أسلوب إدخال مخصّص لنظام التشغيل ChromeOS. يسمح ذلك للإضافة بمعالجة ضغطات المفاتيح وتحديد التركيبة وإدارة نافذة النص المرشّح.
instanceID: Chrome 44 والإصدارات الأحدث

استخدِم chrome.instanceID للوصول إلى خدمة "رقم تعريف المثيل".
loginState: الإصدار 78 من Chrome أو إصدار أحدث نظام التشغيل ChromeOS فقط

استخدِم واجهة برمجة التطبيقات chrome.loginState لقراءة حالة تسجيل الدخول ومراقبتها.
الفيديوهات: توفّر واجهة برمجة التطبيقات chrome.management طرقًا لإدارة التطبيقات والإضافات المثبَّتة.
mimeHandler: الإصدار 151 من Chrome والإصدارات الأحدث

استخدِم واجهة برمجة التطبيقات chrome.mimeHandler للتعامل مع عمليات بث أنواع MIME في الإضافات التابعة لجهات خارجية.
الإشعارات: استخدِم واجهة برمجة التطبيقات chrome.notifications لإنشاء إشعارات غنية باستخدام النماذج وعرض هذه الإشعارات للمستخدمين في لوحة النظام.
مربّع متعدد الاستخدامات: تتيح لك واجهة برمجة التطبيقات الخاصة بالمربّع المتعدد الاستخدامات تسجيل كلمة رئيسية في شريط العناوين في Google Chrome، المعروف أيضًا باسم المربّع المتعدد الاستخدامات.
pageAction: &leq; MV2

استخدِم واجهة برمجة التطبيقات chrome.pageAction لوضع الرموز في شريط أدوات Google Chrome الرئيسي، على يسار شريط العناوين. تمثّل إجراءات الصفحة الإجراءات التي يمكن اتّخاذها على الصفحة الحالية، ولكنّها لا تنطبق على جميع الصفحات. تظهر إجراءات الصفحة باللون الرمادي عندما تكون غير نشطة.
pageCapture: استخدِم واجهة برمجة التطبيقات chrome.pageCapture لحفظ علامة تبويب بتنسيق MHTML.
الأذونات: استخدِم واجهة برمجة التطبيقات chrome.permissions لطلب الأذونات الاختيارية المعلَن عنها في وقت التشغيل بدلاً من وقت التثبيت، حتى يفهم المستخدمون سبب الحاجة إلى الأذونات ولا يمنحوا إلا الأذونات الضرورية.
platformKeys: الإصدار 45 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط

استخدِم واجهة برمجة التطبيقات chrome.platformKeys للوصول إلى شهادات العميل التي يديرها النظام الأساسي. إذا منح المستخدم أو السياسة الإذن، يمكن أن تستخدم الإضافة هذه الشهادة في بروتوكول المصادقة المخصّص. على سبيل المثال، يتيح ذلك استخدام الشهادات المُدارة على مستوى النظام الأساسي في شبكات VPN التابعة لجهات خارجية (راجِع chrome.vpnProvider).
power: استخدِم واجهة برمجة التطبيقات chrome.power لإلغاء ميزات إدارة الطاقة في النظام.
printerProvider: Chrome 44 والإصدارات الأحدث

تعرض واجهة برمجة التطبيقات chrome.printerProvider الأحداث التي يستخدمها "مدير الطباعة" للبحث عن الطابعات التي تتحكّم فيها الإضافات، وللبحث عن إمكاناتها، ولإرسال مهام الطباعة إلى هذه الطابعات.
الطباعة: الإصدار 81 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط

استخدِم واجهة برمجة التطبيقات chrome.printing لإرسال مهام الطباعة إلى الطابعات المثبَّتة على جهاز Chromebook.
printingMetrics: الإصدار 79 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط يتطلّب سياسة

استخدِم واجهة برمجة التطبيقات chrome.printingMetrics لجلب بيانات حول استخدام الطباعة.
الخصوصية: استخدِم واجهة برمجة التطبيقات chrome.privacy للتحكّم في استخدام الميزات في Chrome التي يمكن أن تؤثر في خصوصية المستخدم. تعتمد واجهة برمجة التطبيقات هذه على نموذج ChromeSetting الأوّلي لواجهة برمجة التطبيقات من النوع للحصول على إعدادات Chrome وتحديدها.
العمليات: قناة مطوري البرامج

استخدِم واجهة برمجة التطبيقات chrome.processes للتفاعل مع عمليات المتصفّح.
proxy: استخدِم واجهة برمجة التطبيقات chrome.proxy لإدارة إعدادات الخادم الوكيل في Chrome. تعتمد واجهة برمجة التطبيقات هذه على نموذج ChromeSetting الأوّلي لواجهة برمجة التطبيقات من النوع للحصول على إعدادات الخادم الوكيل وضبطها.
publicSuffix: الإصدار 153 من Chrome والإصدارات الأحدث

استخدِم واجهة برمجة التطبيقات chrome.publicSuffix للاستعلام عن "قائمة اللاحقات العامة" (PSL) في المتصفّح.
وقت التشغيل: استخدِم واجهة برمجة التطبيقات chrome.runtime لاسترداد عامل الخدمة وعرض تفاصيل حول ملف البيان والاستماع إلى الأحداث والاستجابة لها في دورة حياة الإضافة. يمكنك أيضًا استخدام واجهة برمجة التطبيقات هذه لتحويل المسار النسبي لعناوين URL إلى عناوين URL مؤهَّلة بالكامل.
search: Chrome 87 والإصدارات الأحدث

استخدِم واجهة برمجة التطبيقات chrome.search للبحث من خلال مقدّم الخدمة التلقائي.
الجلسات: استخدِم واجهة برمجة التطبيقات chrome.sessions للاستعلام عن علامات التبويب والنوافذ واستعادتها من جلسة تصفّح.
مساحة التخزين: استخدِم واجهة برمجة التطبيقات chrome.storage لتخزين بيانات المستخدمين واستردادها وتتبُّع التغييرات التي تطرأ عليها.
system.cpu: استخدِم واجهة برمجة التطبيقات system.cpu لطلب بيانات تعريف وحدة المعالجة المركزية.
system.display: استخدِم واجهة برمجة التطبيقات system.display لطلب البيانات الوصفية المعروضة.
system.memory: واجهة برمجة التطبيقات chrome.system.memory
system.storage: استخدِم واجهة برمجة التطبيقات chrome.system.storage للاستعلام عن معلومات جهاز التخزين وتلقّي إشعارات عند توصيل جهاز تخزين قابل للإزالة وفصله.
systemLog: الإصدار 125 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط يتطلّب سياسة

استخدِم واجهة برمجة التطبيقات chrome.systemLog لتسجيل سجلّات نظام Chrome من الإضافات.
tabCapture: استخدِم واجهة برمجة التطبيقات chrome.tabCapture للتفاعل مع وسائط علامات التبويب.
علامات التبويب: استخدِم واجهة برمجة التطبيقات chrome.tabs للتفاعل مع نظام علامات التبويب في المتصفّح. يمكنك استخدام واجهة برمجة التطبيقات هذه لإنشاء علامات تبويب وتعديلها وإعادة ترتيبها في المتصفّح.
topSites: استخدِم واجهة برمجة التطبيقات chrome.topSites للوصول إلى أهم المواقع الإلكترونية (أي المواقع الإلكترونية الأكثر زيارةً) التي يتم عرضها في صفحة علامة التبويب الجديدة. ولا تشمل هذه الاختصارات تلك التي يخصّصها المستخدم.
tts: استخدِم واجهة برمجة التطبيقات chrome.tts لتشغيل النص المركّب المحوّل إلى كلام (TTS). راجِع أيضًا واجهة برمجة التطبيقات ttsEngine ذات الصلة، والتي تسمح لإحدى الإضافات بتنفيذ محرّك للتعرّف على الكلام.
ttsEngine: استخدِم واجهة برمجة التطبيقات chrome.ttsEngine لتنفيذ محرّك تحويل النص إلى كلام(TTS) باستخدام إضافة. إذا سجّلت الإضافة باستخدام واجهة برمجة التطبيقات هذه، ستتلقّى أحداثًا تحتوي على عبارة ليتم نطقها ومَعلمات أخرى عندما تستخدم أي إضافة أو تطبيق Chrome واجهة tts API لإنشاء الكلام. يمكن للإضافة بعد ذلك استخدام أي تكنولوجيا ويب متاحة لتركيب الكلام وإخراجه، وإعادة إرسال الأحداث إلى الدالة التي تم استدعاؤها للإبلاغ عن الحالة.
types: تحتوي واجهة برمجة التطبيقات chrome.types على تعريفات أنواع لمتصفّح Chrome.
vpnProvider: الإصدار 43 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط

استخدِم واجهة برمجة التطبيقات chrome.vpnProvider لتنفيذ برنامج شبكة VPN.
الخلفية: الإصدار 43 من Chrome والإصدارات الأحدث نظام التشغيل ChromeOS فقط

استخدِم واجهة برمجة التطبيقات chrome.wallpaper لتغيير خلفية ChromeOS.
webNavigation: استخدِم واجهة برمجة التطبيقات chrome.webNavigation لتلقّي إشعارات بشأن حالة طلبات التنقّل قيد التنفيذ.
webRequest: استخدِم واجهة برمجة التطبيقات chrome.webRequest لمراقبة حركة البيانات وتحليلها، وللتدخّل في الطلبات أثناء نقلها أو حظرها أو تعديلها.
windows: استخدِم واجهة برمجة التطبيقات chrome.windows للتفاعل مع نوافذ المتصفّح. يمكنك استخدام واجهة برمجة التطبيقات هذه لإنشاء النوافذ وتعديلها وإعادة ترتيبها في المتصفّح.

مرجع واجهة برمجة التطبيقات تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

مرجع واجهة برمجة التطبيقات