Chrome 設定のオーバーライド

設定のオーバーライドは、選択した Chrome の設定を拡張機能がオーバーライドする方法です。API は Windows の場合は現行バージョンの Chrome でご利用いただけます。Mac の場合は Chrome 56 以降、 後で説明します

ホームページ、検索プロバイダ、起動ページ

拡張機能マニフェストホームページ検索プロバイダ起動ページを変更する方法の例を次に示します。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_providerhomepagestartup_pages プロパティの値はすべてローカライズ可能 chrome.i18n API を使用します。
  • 外部拡張機能の場合、search_providerhomepagestartup_pages の URL 値は、レジストリキーを使用してパラメータ化できます。新しいレジストリエントリが 「update_url」キー(手順についてはこちらをご覧ください)値名は「install_parameter」で、値データは任意の文字列です。

    {
      "update_url": "https://clients2.google.com/service/update2/crx",
      "install_parameter": "Value"
    }
    

    部分文字列「__PARAM__」のすべての出現はすべての値に置き換えられます 「install_parameter」あります。"install_parameter"存在しない場合は、「__PARAM__」が存在します 削除されます。なお、「__PARAM__」はをホスト名に含めることはできません。URL の最初の「/」の後に配置する必要があります。

リファレンス

拡張機能は、マニフェスト内の次のプロパティの 1 つ以上をオーバーライドできます。

  • homepage(文字列) - 省略可

    ホームページの新しい値。

  • search_provider(オブジェクト) - 省略可

    検索エンジン

    タイプ 属性 説明
    文字列 (省略可)名前

    ユーザーに表示される検索エンジンの名前。prepopulated_id が設定されている場合にのみ省略できます。

    文字列 (省略可)キーワード

    検索エンジンのアドレスバーのキーワード。prepopulated_id が設定されている場合にのみ省略できます。

    文字列 (省略可)favicon_url

    検索エンジンのアイコンの URL。これは、prepopulated_id の場合にのみ省略できます。 設定されます。

    文字列 search_url

    検索エンジンで使用される検索 URL。

    文字列 (省略可)エンコード

    検索語句のエンコード。これは、prepopulated_id が設定されている場合にのみ省略できます。

    文字列 (省略可) suggest_url

    省略すると、このエンジンは候補をサポートしません。

    文字列 (省略可)image_url

    省略すると、このエンジンは画像検索をサポートしません。

    文字列 (省略可)search_url_post_params

    search_url に送信される POST パラメータの文字列

    文字列 (省略可)suggest_url_post_params

    suggest_url への POST パラメータの文字列

    文字列 (省略可)image_url_post_params

    image_url に追加する POST パラメータの文字列

    文字列の配列 (省略可)alternate_urls

    |search_url| に加えて使用できる URL パターンのリスト。

    integer (省略可)prepopulated_id

    Chrome に組み込まれた検索エンジンの ID。

    ブール値 is_default

    検索プロバイダをデフォルトにするかどうかを指定します。

  • startup_pages(文字列の配列) - 省略可

    起動ページとして使用する URL を含む長さ 1 の配列。