إلغاء إعدادات Chrome

تتيح عمليات إلغاء الإعدادات للإضافات إلغاء إعدادات Chrome المحدّدة. واجهة برمجة التطبيقات هي متوفرة على نظام التشغيل Windows في جميع الإصدارات الحالية من Chrome متوفرة على نظام التشغيل Mac في Chrome 56 لاحقًا.

الصفحة الرئيسية وموفِّر خدمة البحث وصفحات بدء التشغيل

في ما يلي مثال على طريقة تعديل الصفحة الرئيسية ومقدّم خدمة البحث وصفحات بدء التشغيل في بيان الإضافة. يجب إثبات ملكية المواقع الإلكترونية المستخدمة في واجهة برمجة تطبيقات الإعدادات (عبر مشرف الموقع الأدوات) باعتبارها مرتبطة بهذا العنصر في سوق Chrome الإلكتروني. يُرجى العِلم أنّه في حال إثبات الملكية بالنسبة إلى نطاق ما (مثل http://example.com)، يمكنك استخدام أي نطاق فرعي أو صفحة (على سبيل المثال، http://app.example.com أو http://example.com/page.html) ضمن إضافتك.

{
  "name": "My extension",
  ...
  "chrome_settings_overrides": {
    "homepage": "http://www.homepage.com",
    "search_provider": {
        "name": "name.__MSG_url_domain__",
        "keyword": "keyword.__MSG_url_domain__",
        "search_url": "http://www.foo.__MSG_url_domain__/s?q={searchTerms}",
        "favicon_url": "http://www.foo.__MSG_url_domain__/favicon.ico",
        "suggest_url": "http://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
        "instant_url": "http://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
        "image_url": "http://www.foo.__MSG_url_domain__/image?q={searchTerms}",
        "search_url_post_params": "search_lang=__MSG_url_domain__",
        "suggest_url_post_params": "suggest_lang=__MSG_url_domain__",
        "instant_url_post_params": "instant_lang=__MSG_url_domain__",
        "image_url_post_params": "image_lang=__MSG_url_domain__",
        "alternate_urls": [
          "http://www.moo.__MSG_url_domain__/s?q={searchTerms}",
          "http://www.noo.__MSG_url_domain__/s?q={searchTerms}"
        ],
        "encoding": "UTF-8",
        "is_default": true
    },
    "startup_pages": ["http://www.startup.com"]
   },
   "default_locale": "de",
   ...
}

تخصيص القيم

يمكن تخصيص القيم في البيان بالطرق التالية:

• يمكن ترجمة كل قِيم السمات search_provider وhomepage وstartup_pages. باستخدام chrome.i18n API.

• بالنسبة إلى الإضافات الخارجية، يمكن لقيم عناوين URL search_provider وhomepage وstartup_pages أن باستخدام مفتاح سجل. يجب إنشاء إدخال جديد للسجل بجوار "update_url" (اطّلِع على التعليمات هنا). اسم القيمة هو "install_parameter"، وقيمته البيانات هي سلسلة عشوائية:

  {
    "update_url": "https://clients2.google.com/service/update2/crx",
    "install_parameter": "Value"
  }
  

  جميع تكرارات السلسلة الفرعية "__PARAM__" في عناوين URL الخاصة بالبيان إلى "install_parameter" إذا كانت "install_parameter" غير موجود، مرات ظهور "__PARAM__" هي تمت إزالته. لاحظ أن "__PARAM__" لا يمكن أن يكون جزءًا من اسم المضيف. وينبغي أن يتم بعد أول '/' في عنوان URL.

مَراجع

يمكن أن تلغي أي إضافة سمة واحدة أو أكثر من السمات التالية في البيان:

• homepage (سلسلة) - اختيارية

  قيمة جديدة للصفحة الرئيسية.

• search_provider (كائن) - اختياري

  محرك بحث

  النوع	السمة	الوصف
  سلسلة	اسم (اختياري)	اسم محرك البحث المعروض للمستخدم ولا يجوز حذف هذا إلا في حال: prepopulated_id.
  سلسلة	الكلمة الرئيسية (اختيارية)	الكلمة الرئيسية للمربّع المتعدد الاستخدامات لمحرك البحث. ولا يجوز حذف هذا إلا في حال: prepopulated_id.
  سلسلة	(اختياري) favicon_url	تمثّل هذه السمة عنوان URL لرمز محرّك البحث. ولا يمكن حذف هذه السمة إلا إذا كانت السمة prepopulated_id. تم تعيينها.
  سلسلة	search_url	عنوان URL للبحث يستخدمه محرك البحث.
  سلسلة	الترميز (اختياري)	ترميز عبارة البحث. ولا يمكن حذف هذه السمة إلا إذا كانت السمة prepopulated_id مضبوطة على. تعيين.
  سلسلة	(اختياري)suggest_url	في حال حذفه، لا يتيح هذا المحرّك إمكانية استخدام الاقتراحات.
  سلسلة	(اختياري) image_url	إذا تم حذفها، لن يتيح هذا المحرّك إمكانية البحث بالصور.
  سلسلة	(اختياري) search_url_post_params	سلسلة معلمات نشر في search_url
  سلسلة	(اختياري)suggest_url_post_params	سلسلة معلمات المشاركة المراد إجراءها بحيث يمكن اقتراح_url
  سلسلة	(اختياري) image_url_post_params	سلسلة معلمات نشر في image_url
  مصفوفة السلسلة	(اختياري)alternate_urls	قائمة بأنماط عناوين URL التي يمكن استخدامها، بالإضافة إلى |search_url|
  عدد صحيح	(اختياري) prefill_id	رقم تعريف محرك البحث المضمَّن في Chrome.
  منطقي	is_default	تحدِّد هذه السياسة ما إذا كان يجب ضبط موفِّر خدمة البحث تلقائيًا.

• startup_pages (مصفوفة من السلاسل) - اختياري

  مصفوفة بطول واحد تحتوي على عنوان URL لاستخدامه كصفحة بدء التشغيل.