שינוי הגדרות 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 אפשר להתאים לשוק המקומי באמצעות chrome.i18n API.

  • במקרה של תוספים חיצוניים, ניתן להגדיר את ערכי כתובות האתרים 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.