設定覆寫功能可讓擴充功能覆寫所選的 Chrome 設定。API 採用 適用於所有現行的 Chrome 版本，適用於 Mac 的 Chrome 56 版
首頁、搜尋供應工具和啟動頁面
以下範例說明如何在擴充功能資訊清單中修改首頁、搜尋提供者和啟動網頁。在設定 API 中使用的網站必須透過網站管理員工具驗證，確認與 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",
...
}
自訂值
資訊清單中的值可以透過下列方式自訂：
- 您可以使用 chrome.i18n API，將
search_provider、homepage和startup_pages屬性的所有值本地化。 如果是外部擴充功能，
search_provider、homepage和startup_pages網址的值可以 必須使用登錄機碼進行參數化您必須建立新的登錄項目， 「更新網址」金鑰 (請參閱這裡的操作說明)。值名稱為「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 要傳送至 suggest_url 的 POST 參數字串
字串 (選用) image_url_post_params image_url 的 post 參數字串
字串陣列 (選用)替代網址 列出可與 |search_url| 搭配使用的網址模式清單。
整數 (選用) prepopulated_id Chrome 內建搜尋引擎的 ID。
布林值 is_default 指定是否應使用預設搜尋引擎。
startup_pages(字串陣列) - 選用長度為 1 的陣列，其中包含要用來做為啟動頁面的網址。