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

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

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

refresh date: 2026-09-25 robots: noindex

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

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

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

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

استخدِم واجهة برمجة التطبيقات هذه لعرض الشهادات للنظام الأساسي الذي يمكنه استخدام هذه الشهادات لمصادقات بروتوكول أمان طبقة النقل (TLS).
الأوامر: استخدِم واجهة برمجة التطبيقات للأوامر لإضافة اختصارات لوحة المفاتيح التي تؤدي إلى تنفيذ إجراءات في الإضافة، مثل إجراء لفتح إجراء المتصفّح أو إرسال أمر إلى الإضافة.
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: الإصدار 84 من Chrome والإصدارات الأحدث

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

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

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

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

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

استخدِم واجهة برمجة التطبيقات 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 والإصدارات الأحدث نظام التشغيل Chrome فقط يتطلب تفعيل السياسة

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

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

استخدِم واجهة برمجة التطبيقات chrome.enterprise.platformKeys لإنشاء المفاتيح وتثبيت الشهادات لهذه المفاتيح. ستتم إدارة الشهادات من خلال النظام الأساسي ويمكن استخدامها لمصادقة بروتوكول أمان طبقة النقل (TLS) أو الوصول إلى الشبكة أو من خلال إضافة أخرى عبر chrome.platformKeys.
الأحداث: تحتوي مساحة الاسم chrome.events على أنواع شائعة تستخدمها واجهات برمجة التطبيقات لإرسال الأحداث لإعلامك عند حدوث أمر مهم.
الإضافة: تتضمّن واجهة برمجة التطبيقات 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).
history: استخدِم واجهة برمجة التطبيقات chrome.history للتفاعل مع سجلّ المتصفّح للصفحات التي تمت زيارتها. يمكنك إضافة عناوين URL وإزالتها والاستعلام عنها في سجلّ المتصفّح. لتجاوز صفحة السجلّ بنسختك الخاصة، يُرجى الاطّلاع على تجاوز الصفحات.
i18n: استخدِم البنية الأساسية لـ chrome.i18n لتنفيذ عملية التدويل في تطبيقك أو إضافتك بالكامل.
identity: استخدِم واجهة برمجة التطبيقات chrome.identity للحصول على رموز الدخول OAuth2.
idle: استخدِم واجهة برمجة التطبيقات chrome.idle لرصد أي تغيير في حالة عدم النشاط على الجهاز.
input.ime: نظام التشغيل ChromeOS فقط

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

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

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

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

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

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

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

استخدِم واجهة برمجة التطبيقات 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: الإصدار 87 من Chrome أو الإصدارات الأحدث

استخدِم واجهة برمجة التطبيقات chrome.search للبحث من خلال مقدّم الخدمة التلقائي.
الجلسات: استخدِم واجهة برمجة التطبيقات chrome.sessions لطلب علامات التبويب والنوافذ واستعادتها من جلسة تصفّح.
storage: استخدِم واجهة برمجة التطبيقات 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 لإنشاء الكلام. يمكن لإضافتك بعد ذلك استخدام أي تكنولوجيا ويب متاحة لتجميع الكلام وإخراجه، وإرسال الأحداث مرة أخرى إلى دالة الاستدعاء للإبلاغ عن الحالة.
types: تحتوي واجهة برمجة التطبيقات chrome.types على تعريفات الأنواع لمتصفّح Chrome.
vpnProvider: الإصدار 43 من Chrome والإصدارات الأحدث نظام التشغيل Chrome فقط

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

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

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

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