ביטול הגדרות מאפשר לתוספים לבטל את ההגדרות שנבחרו ב-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
.