Chrome 設定のオーバーライド

設定のオーバーライドは、選択した Chrome の設定を拡張機能がオーバーライドする方法です。API は 現在のすべてのバージョンの Chrome で Windows と Mac でご利用いただけます。

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

こちらは、ホームページ、検索プロバイダ、起動ページを変更する方法の例です。 拡張機能のマニフェスト内。Settings API で使用するドメインはすべて、所有権の証明を（ Google Search Console など）。なお、 ドメイン（例: https://example.com）の所有権を確認します。任意のサブドメインまたはページを使用できます （例: https://app.example.com、https://example.com/page.html）。

この設定を使用することにより権限がオーバーライドされ、同時に追加の機能や権限もリクエストすることは、YouTube の単一の目的に関するポリシーに反します。Chrome では、Google の単一用途に関するポリシーに違反している可能性があるアイテムが検出されると、確認ダイアログがユーザーに表示されます。追加の機能や権限を求めずに 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__" をホスト名に含めることはできません。イベントの終了後に 先頭の '/'あります。

リファレンス

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

alternate_urls（文字列の配列、省略可）
search_url. に加えて使用できる URL パターンのリスト
encoding（文字列、省略可）
検索キーワードに使用されるエンコード。prepopulated_id を設定しない場合は必須です。
favicon_url（文字列、省略可）
検索エンジンのアイコンの URL。prepopulated_id を設定しない場合は必須です。
homepage（文字列、省略可）
ホームページの新しい値。
image_url（文字列、省略可）
検索エンジンが画像検索に使用する URL。このパラメータを指定しなかった場合、このエンジンは画像検索をサポートしません。
image_url_post_params（文字列、省略可）
image_url の POST パラメータ。
is_default（ブール値、必須）
検索プロバイダをデフォルトにするかどうかを指定します。
keyword（文字列、省略可）
検索エンジンのアドレスバーのキーワード。prepopulated_id を設定しない場合は必須です。
name（文字列、省略可）
ユーザーに表示される検索エンジンの名前。prepopulated_id を設定しない場合は必須です。
prepopulated_id（整数、省略可）
Chrome に組み込まれた検索エンジンの ID。
search_provider（オブジェクト、省略可）
検索エンジン。
search_url（文字列、必須）
検索エンジンが使用する検索 URL。
search_url_post_params（文字列、省略可）
search_url の POST パラメータ。
startup_pages（文字列の配列、省略可）
起動ページとして使用される URL を含む長さの配列。
suggest_url（文字列、省略可）
検索エンジンが候補表示に使用する URL。これを使用しない場合、エンジンは候補をサポートしません。
suggest_url_post_params（文字列、省略可）
suggest_url の POST パラメータ。