שינוי הגדרות Chrome

שינוי ההגדרות מאפשר לתוספים לבטל את הגדרות Chrome שנבחרו. ה-API הוא ב-Windows וב-Mac בכל הגרסאות הנוכחיות של Chrome.

דף הבית, ספק החיפוש ודפי פתיחה

הנה דוגמה לאופן שבו ניתן לשנות דף הבית, ספק חיפוש ודפי פתיחה במניפסט התוסף. כל דומיין שבו נעשה שימוש ב-API של ההגדרות צריך להיות מאומת (דרך 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 באמצעות API של chrome.i18n.

  • בתוספים חיצוניים, ערכי כתובות ה-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 (מערך מחרוזות, אופציונלי)
מערך באורך 1 שמכיל כתובת URL שתשמש כדף הפתיחה.
suggest_url (מחרוזת, אופציונלי)
כתובת ה-URL שבה מנוע החיפוש משתמש להצעות. אם לא משתמשים באפשרות הזו, המנוע לא תומך בהצעות.
suggest_url_post_params (מחרוזת, אופציונלי)
הפרמטרים של פוסט עבור suggest_url.