การลบล้างการตั้งค่า Chrome

การลบล้างการตั้งค่าเป็นวิธีที่ส่วนขยายจะลบล้างการตั้งค่า 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