覆寫 Chrome 設定

設定覆寫可讓擴充功能覆寫所選 Chrome 設定。API 採用 適用於所有現行的 Chrome 版本，適用於 Mac 的 Chrome 56 版

首頁、搜尋引擎和起始網頁

以下示例說明如何在首頁、搜尋引擎和起始網頁中修改 擴充功能資訊清單。用於設定 API 的網站必須經由網站管理員驗證 )。請注意，如果您驗證擁有權 的網域 (例如 http://example.com)，您可以使用任何子網域或網頁 (例如 http://app.example.com 或 http://example.com/page.html)。

{
  "name": "My extension",
  ...
  "chrome_settings_overrides": {
    "homepage": "http://www.homepage.com",
    "search_provider": {
        "name": "name.__MSG_url_domain__",
        "keyword": "keyword.__MSG_url_domain__",
        "search_url": "http://www.foo.__MSG_url_domain__/s?q={searchTerms}",
        "favicon_url": "http://www.foo.__MSG_url_domain__/favicon.ico",
        "suggest_url": "http://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
        "instant_url": "http://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
        "image_url": "http://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": [
          "http://www.moo.__MSG_url_domain__/s?q={searchTerms}",
          "http://www.noo.__MSG_url_domain__/s?q={searchTerms}"
        ],
        "encoding": "UTF-8",
        "is_default": true
    },
    "startup_pages": ["http://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__」的位置中的 "install_parameter"值。如果「install_parameter」不存在，出現「__PARAM__」是 已移除請注意，「__PARAM__」不得加入主機名稱。必須在 第一個「/」。

參考資料

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

• homepage (字串) - 選用

  首頁的新值。

• search_provider (物件) - 選用

  搜尋引擎

  類型	屬性	說明
  字串	(選填) 名稱	向使用者顯示的搜尋引擎名稱。只有在 已設定 prepopulated_id。
  字串	(選用) 關鍵字	搜尋引擎的網址列關鍵字。只有在 已設定 prepopulated_id。
  字串	(選用) favicon_url	搜尋引擎的圖示網址。只有在 prepopulated_id 的情況下才能省略 資源。
  字串	search_url	搜尋引擎所使用的搜尋網址。
  字串	(選用) 編碼	搜尋字詞的編碼。只有在 prepopulated_id 為 設定。
  字串	(選用)suggest_url	如果省略，這個引擎將不支援建議功能。
  字串	(選用) image_url	如果省略，此引擎將不支援圖片搜尋功能。
  字串	(選用) search_url_post_params	search_url 的貼文參數字串
  字串	(選用)suggest_url_post_params	建議_url 的貼文參數字串
  字串	(選用) image_url_post_params	image_url 的 post 參數字串
  字串陣列	(選用)替代網址	列出可與 |search_url| 搭配使用的網址模式清單。
  整數	(選用) prefill_id	Chrome 內建搜尋引擎的 ID。
  布林值	is_default	指定是否應使用預設的搜尋引擎。

• startup_pages (字串陣列) - 選用

  長度 1 的陣列，包含要做為起始網頁的網址。