覆寫 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_providerhomepagestartup_pages 的所有值都可以本地化 使用 chrome.i18n API
  • 如果是外部擴充功能search_providerhomepagestartup_pages 網址的值可以 必須使用登錄機碼進行參數化在您的 "update_url" 金鑰 (請參閱這裡的操作說明)。索引鍵名稱為 "install_parameter",值為 為任意字串:

    {
      "update_url": "https://clients2.google.com/service/update2/crx",
      "install_parameter": "Value"
    }
    

    資訊清單中所有子字串 "__PARAM__" 都會替換為 "install_parameter" 的值。如果缺少 "install_parameter",就會發生 "__PARAM__" 已移除請注意,"__PARAM__" 不能是主機名稱的一部分。必須在 第一個「/」。

參考資料

擴充功能可以覆寫資訊清單中的下列一或多項屬性:

alternate_urls (字串陣列,選用)
可與 search_url. 搭配使用的網址模式清單
encoding (字串,選用)
搜尋字詞使用的編碼。如未設定 prepopulated_id,這是必要做法。
favicon_url (字串,選用)
搜尋引擎的圖示網址。如未設定 prepopulated_id,這是必要做法。
homepage (字串,選用)
首頁的新值。
image_url (字串,選用)
搜尋引擎用於搜尋圖片的網址。如果您沒有使用這個選項,表示引擎不支援圖片搜尋功能。
image_url_post_params (字串,選用)
image_url 的貼文參數。
is_default (布林值,必要)
用於指定是否要預設搜尋引擎。
keyword (字串,選用)
搜尋引擎的網址列關鍵字。如未設定 prepopulated_id,這是必要做法。
name (字串,選用)
向使用者顯示的搜尋引擎名稱。如未設定 prepopulated_id,這是必要做法。
prepopulated_id (整數,選用)
Chrome 內建搜尋引擎的 ID。
search_provider (物件,選用)
搜尋引擎。
search_url (字串,必要)
搜尋引擎使用的搜尋網址。
search_url_post_params (字串,選用)
search_url 的貼文參數。
startup_pages (字串陣列,選用)
長度 1 的陣列,包含要做為起始網頁的網址。
suggest_url (字串,選用)
搜尋引擎在建議中使用的網址。如未使用這個選項,引擎就無法支援建議功能。
suggest_url_post_params (字串,選用)
suggest_url 的貼文參數。