Chrome-Einstellungen überschreiben

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

Startseite, Suchanbieter und Startseiten

Hier ein Beispiel für die Änderung der Startseite, des Suchanbieters und der Startseiten: im Erweiterungsmanifest. Jede Domain, die in der Settings API verwendet wird, muss bestätigt werden (über Google Search Console) über dasselbe Entwicklerkonto, das die Erweiterung veröffentlicht. Wenn Sie Bestätigen Sie die Inhaberschaft für eine Domain (z. B. https://beispiel.de). Sie können jede Subdomain oder Seite verwenden. z. B. https://app.beispiel.de oder https://beispiel.de/seite.html.

Wenn Sie die Berechtigung zum Überschreiben der Einstellungen verwenden und gleichzeitig zusätzliche Funktionen oder Berechtigungen anfordern, entspricht dies nicht unserer Richtlinie zum alleinigen Zweck. Wenn Chrome feststellt, dass ein Artikel möglicherweise gegen unsere Richtlinie für den alleinigen Zweck verstößt, wird dem Nutzer ein Bestätigungsdialogfeld angezeigt. Erweiterungen, die sich darauf beschränken, nur eine Einstellung zu ändern, ohne zusätzliche Funktionen oder Berechtigungen anfordern zu müssen, erhalten kein Bestätigungsdialogfeld.

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

Die Werte im Manifest können folgendermaßen angepasst werden:

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

  • Für externe Erweiterungen können die URL-Werte search_provider, homepage und startup_pages mit einem Registrierungsschlüssel parametrisiert werden. Erstellen Sie einen neuen Registrierungseintrag neben dem "update_url"-Schlüssel (siehe Anleitung) 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 "install_parameter"-Wert. Wenn "install_parameter" nicht vorhanden ist, werden "__PARAM__"-Ereignisse wie folgt definiert: entfernt. "__PARAM__" darf nicht Teil des Hostnamens sein. Sie muss nach der erster '/' in der URL.

Referenz

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

alternate_urls (Stringarray, 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 Beitragsparameter für image_url.
is_default (boolesch, erforderlich)
Gibt an, ob der Suchanbieter als Standardsuchanbieter 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)
Eine ID für die integrierte Suchmaschine von Chrome.
search_provider (Objekt, optional)
Eine Suchmaschine
search_url (String, erforderlich)
Die Such-URL, die von der Suchmaschine verwendet wird.
search_url_post_params (String, optional)
Die Beitragsparameter für search_url.
startup_pages (Stringarray, optional)
Ein Array mit der Länge 1, 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 Beitragsparameter für suggest_url.