การลบล้างการตั้งค่าเป็นวิธีที่ส่วนขยายจะลบล้างการตั้งค่า Chrome ที่เลือกไว้ API พร้อมใช้งานใน Windows และ Mac ใน Chrome เวอร์ชันปัจจุบันทั้งหมด
หน้าแรก ผู้ให้บริการการค้นหา และหน้าเริ่มต้นใช้งาน
ต่อไปนี้เป็นตัวอย่างวิธีแก้ไขหน้าแรก ผู้ให้บริการการค้นหา และหน้าเริ่มต้นใช้งานในไฟล์ Manifest ของส่วนขยาย โดเมนที่ใช้ใน 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",
...
}
การกำหนดค่า
คุณปรับแต่งค่าในไฟล์ Manifest ได้ด้วยวิธีต่อไปนี้
- ค่าทั้งหมดของพร็อพเพอร์ตี้
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 ของไฟล์ Manifest จะแทนที่ด้วยค่า"install_parameter"
หากไม่มี"install_parameter"
ระบบจะนำรายการ"__PARAM__"
ออก โปรดทราบว่า"__PARAM__"
ไม่สามารถเป็นส่วนหนึ่งของชื่อโฮสต์ได้ โดยจะต้องอยู่ต่อจาก "/" แรกใน URL
ข้อมูลอ้างอิง
ส่วนขยายจะลบล้างพร็อพเพอร์ตี้ต่อไปนี้อย่างน้อย 1 รายการในไฟล์ Manifest ได้
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