Chrome 設定のオーバーライド

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

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

次に、ホームページ検索プロバイダ起動ページ拡張機能のマニフェストをご覧ください。Settings API で使用するウェブサイトは確認する必要がある(ウェブマスターによる) ツールなど)は、Chrome ウェブストアでそのアイテムと関連付けられます。所有権の確認は ドメイン(例: http://example.com)には、任意のサブドメインまたはページ(例: (http://app.example.com または http://example.com/page.html など)を拡張機能の 1 つに含めることができます。

{
  "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」で、 data は任意の文字列です。

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

    部分文字列「__PARAM__」のすべての出現は、マニフェスト URL 内の対応する部分に "install_parameter"あります。"install_parameter"存在しない場合は、「__PARAM__」が存在します 削除されます。なお、「__PARAM__」はをホスト名に含めることはできません。イベントの終了後に 先頭の '/'あります。

リファレンス

拡張機能は、マニフェスト内の次のプロパティの 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

    prepare_url への投稿パラメータの文字列

    文字列 (省略可)image_url_post_params

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

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

    |search_url| に加えて、使用可能な URL パターンのリスト。

    integer (省略可)prepop_id

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

    ブール値 is_default

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

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

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