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

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

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

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

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

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

{
  "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.