การลบล้างการตั้งค่า 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