設定のオーバーライドは、選択した Chrome 設定を拡張機能がオーバーライドする方法です。この API は Windows と Mac に対応しており、最新のすべてのバージョンの Chrome で使用できます。
ホームページ、検索プロバイダ、起動ページ
拡張機能のマニフェストでホームページ、検索プロバイダ、起動ページを変更する方法の例を以下に示します。設定 API で使用されるドメインはすべて、拡張機能を公開しているデベロッパー アカウントによって(Google Search Console を介して)確認される必要があります。ドメイン(https://example.com など)の所有権を確認する場合は、拡張機能内で任意のサブドメインまたはページ(https://app.example.com や https://example.com/page.html など)を使用できます。
権限のオーバーライド設定を使って同時に追加の機能や権限をリクエストすることは、Google の単一目的のポリシーに反します。Chrome の単一目的に関するポリシーに違反している可能性のあるアイテムが検出されると、確認ダイアログがユーザーに表示されます。追加機能や権限を求めることなく 1 つの設定のみを変更できる拡張機能の場合、確認ダイアログは表示されません。
これは Chrome 107 以降に適用されます。
{
"name": "My extension",
...
"chrome_settings_overrides": {
"homepage": "https://www.homepage.com",
"search_provider": {
"name": "name.__MSG_url_domain__",
"keyword": "keyword.__MSG_url_domain__",
"search_url": "https://www.foo.__MSG_url_domain__/s?q={searchTerms}",
"favicon_url": "https://www.foo.__MSG_url_domain__/favicon.ico",
"suggest_url": "https://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
"instant_url": "https://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
"image_url": "https://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": [
"https://www.moo.__MSG_url_domain__/s?q={searchTerms}",
"https://www.noo.__MSG_url_domain__/s?q={searchTerms}"
],
"encoding": "UTF-8",
"is_default": true
},
"startup_pages": ["https://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 つ以上をオーバーライドできます。
alternate_urls
(文字列の配列、省略可)search_url.
に加えて使用できる URL パターンのリストencoding
(文字列、省略可)- 検索キーワードに使用されるエンコード。
prepopulated_id
を設定しない場合は必須です。 favicon_url
(文字列、省略可)- 検索エンジンのアイコン URL。
prepopulated_id
を設定しない場合は必須です。 homepage
(文字列、省略可)- ホームページの新しい値。
image_url
(文字列、省略可)- 検索エンジンが画像検索に使用する URL。この属性を使用しない場合、エンジンは画像検索に対応していません。
image_url_post_params
(文字列、省略可)image_url
の送信パラメータ。is_default
(ブール値、必須)- 検索プロバイダをデフォルトにするかどうかを指定します。
keyword
(文字列、省略可)- 検索エンジンのアドレスバー キーワード。
prepopulated_id
を設定しない場合は必須です。 name
(文字列、省略可)- ユーザーに表示される検索エンジンの名前。
prepopulated_id
を設定しない場合は必須です。 prepopulated_id
(整数、省略可)- Chrome に組み込まれている検索エンジンの ID。
search_provider
(オブジェクト、省略可)- 検索エンジン
search_url
(文字列、必須)- 検索エンジンが使用する検索 URL。
search_url_post_params
(文字列、省略可)search_url
の送信パラメータ。startup_pages
(文字列の配列、省略可)- 起動ページとして使用される URL を含む長さ 1 の配列。
suggest_url
(文字列、省略可)- 検索エンジンが候補に使用する URL。この属性を使用しない場合、エンジンは提案をサポートしません。
suggest_url_post_params
(文字列、省略可)suggest_url
の送信パラメータ。