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

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

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

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

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

ينطبق ذلك على Chrome 107 والإصدارات الأحدث.

{
  "name": "My extension",
  ...
  "chrome_settings_overrides": {
    "homepage": "https://www.homepage.com",
    "search_provider": {
        "name": "name.__MSG_url_domain__",
        "keyword": "keyword.__MSG_url_domain__",
        "search_url": "https://www.foo.__MSG_url_domain__/s?q={searchTerms}",
        "favicon_url": "https://www.foo.__MSG_url_domain__/favicon.ico",
        "suggest_url": "https://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
        "instant_url": "https://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
        "image_url": "https://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": [
          "https://www.moo.__MSG_url_domain__/s?q={searchTerms}",
          "https://www.noo.__MSG_url_domain__/s?q={searchTerms}"
        ],
        "encoding": "UTF-8",
        "is_default": true
    },
    "startup_pages": ["https://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.

مَراجع

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

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