Chrome-Einstellungen überschreiben

Mit Überschreibungen von Einstellungen können Erweiterungen ausgewählte Chrome-Einstellungen überschreiben. Die API ist in allen aktuellen Chrome-Versionen für Windows und Mac verfügbar.

Startseite, Suchanbieter und „Beim Start“-Seiten

Das folgende Beispiel zeigt, wie die Startseite, der Suchanbieter und die Startseiten im Erweiterungsmanifest geändert werden können. Alle in der Settings API verwendeten Domains müssen über die Google Search Console von demselben Entwicklerkonto bestätigt werden, über das die Erweiterung veröffentlicht wird. Wenn Sie die Inhaberschaft für eine Domain bestätigen (z. B. https://beispiel.de), können Sie eine beliebige Subdomain oder Seite (z. B. https://app.beispiel.de oder https://beispiel.de/seite.html) in der Erweiterung verwenden.

Wenn Sie die Berechtigung „Einstellungen“ überschreiben, aber gleichzeitig zusätzliche Funktionen oder Berechtigungen anfordern, verstößt das gegen unsere zweckgebundene Richtlinie. Wenn Chrome feststellt, dass ein Artikel potenziell gegen unsere Richtlinie zu einem einzigen Zweck verstößt, wird ein Bestätigungsdialogfeld angezeigt. Bei Erweiterungen, die nur eine einzige Einstellung ändern können, ohne nach zusätzlichen Funktionen oder Berechtigungen zu suchen, wird kein Bestätigungsdialogfeld angezeigt.

Dies gilt für Chrome 107 und höher.

{
  "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",
   ...
}

Werte anpassen

Werte im Manifest können so angepasst werden:

  • Alle Werte der Properties search_provider, homepage und startup_pages können mithilfe der chrome.i18n API lokalisiert werden.

  • Für externe Erweiterungen können die URL-Werte search_provider, homepage und startup_pages mit einem Registrierungsschlüssel parametriert werden. Erstellen Sie neben dem Schlüssel "update_url" einen neuen Registry-Eintrag. Eine entsprechende Anleitung finden Sie hier. Der Schlüsselname ist "install_parameter", der Wert ist ein beliebiger String:

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

    Alle Vorkommen des Teilstrings "__PARAM__" in den Manifest-URLs werden durch den Wert "install_parameter" ersetzt. Wenn "install_parameter" nicht vorhanden ist, werden Vorkommen von "__PARAM__" entfernt. "__PARAM__" darf nicht Teil des Hostnamens sein. Er muss nach dem ersten Schrägstrich in der URL stehen.

Referenz

Eine Erweiterung kann eine oder mehrere der folgenden Eigenschaften im Manifest überschreiben:

alternate_urls (Array aus Strings, optional)
Eine Liste mit URL-Mustern, die zusätzlich zu search_url. verwendet werden können
encoding (String, optional)
Die für Suchbegriffe verwendete Codierung. Dies ist erforderlich, wenn Sie prepopulated_id nicht festlegen.
favicon_url (String, optional)
Eine Symbol-URL für die Suchmaschine. Dies ist erforderlich, wenn Sie prepopulated_id nicht festlegen.
homepage (String, optional)
Der neue Wert für die Startseite.
image_url (String, optional)
Die URL, die die Suchmaschine für die Bildersuche verwendet. Andernfalls unterstützt die Suchmaschine keine Bildersuche.
image_url_post_params (String, optional)
Die Post-Parameter für image_url.
is_default (boolesch, erforderlich)
Gibt an, ob der Suchanbieter standardmäßig verwendet werden soll.
keyword (String, optional)
Ein Omnibox-Keyword für die Suchmaschine. Dies ist erforderlich, wenn Sie prepopulated_id nicht festlegen.
name (String, optional)
Name der Suchmaschine, die dem Nutzer angezeigt wird. Dies ist erforderlich, wenn Sie prepopulated_id nicht festlegen.
prepopulated_id (Ganzzahl, optional)
ID für die in Chrome integrierte Suchmaschine.
search_provider (Objekt, optional)
Eine Suchmaschine.
search_url (String, erforderlich)
Die Such-URL, die die Suchmaschine verwendet.
search_url_post_params (String, optional)
Die Post-Parameter für search_url.
startup_pages (Array aus Strings, optional)
Ein Array mit einer Länge von 1 Zeichen, das eine URL enthält, die als „Beim Start“-Seite verwendet werden soll.
suggest_url (String, optional)
Die URL, die die Suchmaschine für Vorschläge verwendet. Andernfalls unterstützt die Suchmaschine keine Vorschläge.
suggest_url_post_params (String, optional)
Die Post-Parameter für suggest_url.