覆寫 Chrome 設定

如要讓擴充功能覆寫選取的 Chrome 設定,就必須覆寫設定。這個 API 可在 Windows 的所有目前 Chrome 版本中提供,且可在 Chrome 56 以上版本的 Mac 上使用。

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

以下是在擴充功能資訊清單中修改首頁搜尋引擎起始網頁的範例。透過設定 API 使用的網站,必須經由 Search Console 驗證,將其與 Chrome 線上應用程式商店中的該項目建立關聯。請注意,如果您為網域 (例如 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_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__」不可做為主機名稱的一部分。必須在網址的第一個「/」之後出現。

參考資料

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

  • 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 的 post 參數字串

    字串 (選用)suggest_url_post_params

    建議_url 的 post 參數字串

    字串 (選用) image_url_post_params

    image_url 的 post 參數字串

    字串陣列 (選用) 替代網址

    可用於 |search_url| 以外的網址模式清單。

    整數 (選用) pre 填入的 ID

    Chrome 內建搜尋引擎的 ID。

    boolean is_default

    指定是否要預設搜尋引擎。

  • startup_pages (字串陣列) - 選用

    一段長度的陣列,其中包含用來做為起始網頁的網址。