設定のオーバーライドは、選択した 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" }
部分文字列「__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 の配列。