設定のオーバーライドは、選択した 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_provider
、homepage
、startup_pages
プロパティのすべての値は、chrome.i18n API を使用してローカライズできます。外部拡張機能の場合、レジストリキーを使用して
search_provider
、homepage
、startup_pages
の URL 値をパラメータ化できます。新しいレジストリ エントリが「update_url」キーの横に作成されます(こちらの手順をご覧ください)。値の名前は「install_parameter」、値データは任意の文字列です。{ "update_url": "https://clients2.google.com/service/update2/crx", "install_parameter": "Value" }
マニフェスト URL に含まれる部分文字列「__PARAM__」はすべて「install_parameter」の値に置き換えられます。「install_parameter」が存在しない場合、「__PARAM__」は削除されます。「__PARAM__」をホスト名に含めることはできません。URL の最初の「/」の後に配置する必要があります。
リファレンス
拡張機能は、マニフェストの次のプロパティの 1 つ以上をオーバーライドできます。
homepage
(文字列) - 省略可ホームページの新しい値。
search_provider
(オブジェクト) - 省略可検索エンジン
種類 属性 説明 string (省略可)name ユーザーに表示される検索エンジンの名前。これは、prepopulated_id が設定されている場合にのみ省略できます。
string (省略可)キーワード 検索エンジンのアドレスバー キーワード。これは、prepopulated_id が設定されている場合にのみ省略できます。
string (省略可)favicon_url 検索エンジンのアイコンの URL。これは、prepopulated_id が設定されている場合にのみ省略できます。
string search_url 検索エンジンが使用する検索 URL。
string (省略可)エンコード 検索キーワードのエンコード。これは、prepopulated_id が設定されている場合にのみ省略できます。
string (省略可)suggest_url 省略した場合、このエンジンは提案をサポートしません。
string (省略可)image_url 省略した場合、このエンジンは画像検索をサポートしていません。
string (省略可)search_url_post_params search_url に渡す POST パラメータの文字列
string (省略可)suggest_url_post_params suggest_url に渡す投稿パラメータの文字列
string (省略可)image_url_post_params image_url に渡す POST パラメータの文字列
文字列の配列 (省略可)alternate_urls |search_url| に加えて使用できる URL パターンのリスト。
整数 (省略可)prepending_id Chrome に組み込まれている検索エンジンの ID。
boolean is_default 検索プロバイダをデフォルトにするかどうかを指定します。
startup_pages
(文字列の配列) - 省略可起動ページとして使用される URL を含む長さ 1 の配列。