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

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

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

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

  {
    "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	سلسلة مَعلمات POST إلى search_url
  سلسلة	(اختياري)suggest_url_post_params	سلسلة مَعلمات POST إلى suggest_url
  سلسلة	(اختياري) image_url_post_params	سلسلة معلمات نشر في image_url
  مصفوفة من السلاسل	(اختياري) alternate_urls	قائمة بأنماط عناوين URL التي يمكن استخدامها، بالإضافة إلى |search_url|
  عدد صحيح	(اختياري) prepopulated_id	رقم تعريف محرك البحث المضمّن في Chrome
  منطقي	is_default	يحدّد ما إذا كان يجب ضبط مقدّم خدمة البحث على الإعداد التلقائي.

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

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