تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

accessibilityFeatures: استخدِم واجهة برمجة التطبيقات chrome.accessibilityFeatures لإدارة ميزات تسهيل الاستخدام في Chrome. تعتمد واجهة برمجة التطبيقات هذه على نموذج ChromeSetting الأوّلي لواجهة برمجة التطبيقات من النوع API للحصول على ميزات تسهيل الاستخدام الفردية وضبطها. للحصول على حالات الميزات، يجب أن تطلب الإضافة إذن accessibilityFeatures.read. لتعديل حالة الميزة، تحتاج الإضافة إلى إذن accessibilityFeatures.modify. يُرجى العِلم أنّ accessibilityFeatures.modify لا يعني الحصول على إذن accessibilityFeatures.read.
المنبّهات: استخدِم واجهة برمجة التطبيقات 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).
الأوامر: استخدِم واجهة برمجة التطبيقات "الأوامر" لإضافة اختصارات لوحة المفاتيح التي تؤدي إلى تنفيذ إجراءات في الإضافة، مثل إجراء لفتح إجراء المتصفّح أو إرسال أمر إلى الإضافة.
contentSettings: استخدِم واجهة برمجة التطبيقات chrome.contentSettings لتغيير الإعدادات التي تتحكّم في ما إذا كان بإمكان المواقع الإلكترونية استخدام ميزات مثل ملفات تعريف الارتباط وجافا سكريبت والمكوّنات الإضافية. بشكل عام، تتيح لك إعدادات المحتوى تخصيص سلوك 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; 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: الإصدار 129 من Chrome والإصدارات الأحدث

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

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

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

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

استخدِم واجهة برمجة التطبيقات chrome.loginState لقراءة حالة تسجيل الدخول ومراقبتها.
الفيديوهات: توفّر واجهة برمجة التطبيقات chrome.management طرقًا لإدارة التطبيقات والإضافات المثبَّتة.
الإشعارات: استخدِم واجهة برمجة التطبيقات 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 الأوّلي من النوع API للحصول على إعدادات الخادم الوكيل وضبطها.
runtime: استخدِم واجهة برمجة التطبيقات 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 أو إصدار أحدث نظام التشغيل ChromeOS فقط

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

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

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

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