覆盖 Chrome 设置

设置替换项是扩展程序替换所选 Chrome 设置的方式。该 API 适用于 Windows 上所有现行版本的 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",
   ...
}

自定义值

您可以通过以下方式自定义清单中的值:

  • search_providerhomepagestartup_pages 属性的所有值都可以本地化 使用 chrome.i18n API
  • 对于外部扩展程序search_providerhomepagestartup_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

    搜索引擎的图标网址。仅当设置了 prepopulated_id 时,才能省略此字段。

    字符串 search_url

    搜索引擎使用的搜索网址。

    字符串 (可选)编码

    搜索字词的编码。仅当设置了 prepopulated_id 时,才能省略此字段。

    字符串 (可选)suggest_url

    如果省略,此引擎不支持建议。

    字符串 (可选)image_url

    如果省略,则此引擎不支持图片搜索。

    字符串 (可选)search_url_post_params

    要发送到 search_url 的 POST 参数的字符串

    字符串 (可选)suggest_url_post_params

    Recommendations_url 的 POST 参数字符串

    字符串 (可选)image_url_post_params

    要发送到 image_url 的 POST 参数的字符串

    字符串数组 (可选)Alternate_urls

    除了 |search_url| 之外,可使用的网址格式列表。

    integer (可选)prepopulated_id

    Chrome 中内置搜索引擎的 ID。

    布尔值 is_default

    指定搜索提供商是否应设为默认。

  • startup_pages(字符串数组)- 可选

    长度为 1 的数组,其中包含用作启动页的网址。