设置覆盖是扩展程序覆盖所选 Chrome 设置的一种方式。API 是 适用于 Windows 上(在当前所有版本的 Chrome 中),适用于 Mac 和 Chrome 56 及 。
首页、搜索服务提供商和启动页
下面的示例展示了如何在 Google Cloud 控制台中修改首页、搜索服务提供商和启动页 扩展程序清单。Settings 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",
...
}
自定义值
可以通过以下方式自定义清单中的值:
search_provider
、homepage
和startup_pages
属性的所有值都可以本地化 使用 chrome.i18n API。对于外部扩展程序,
search_provider
、homepage
和startup_pages
网址值可以 并使用注册表项参数化。系统应该会在 "update_url"键(请参阅此处的说明)。值名称为“install_parameter”,值为 data 为任意字符串:{ "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 搜索引擎的图标网址。只有当 ID 为 prepopulated_id 时,该字段才可能省略 。
字符串 search_url 搜索引擎使用的搜索网址。
字符串 (可选)编码 搜索字词的编码。只有当 prepopulated_id 为 。
字符串 (可选)suggest_url 如果省略,则此引擎不支持建议。
字符串 (可选)image_url 如果省略,则此引擎不支持图片搜索。
字符串 (可选)search_url_post_params search_url 的博文参数字符串
字符串 (可选)suggest_url_post_params 指向 suggest_url 的博文参数字符串
字符串 (可选)image_url_post_params image_url 的博文参数字符串
字符串数组 (可选)Alternate_urls 除 |search_url| 之外可以使用的网址格式列表。
integer (可选)prefilld_id Chrome 中内置搜索引擎的 ID。
布尔值 is_default 指定是否应将搜索提供程序设为默认搜索提供程序。
startup_pages
(字符串数组)- 可选长度为 1 的数组,其中包含用作启动页的网址。