Chrome-instellingen overschrijven

Het overschrijven van instellingen is een manier waarop extensies geselecteerde Chrome-instellingen kunnen overschrijven. De API is beschikbaar op Windows en Mac in alle huidige versies van Chrome.

Startpagina, zoekmachine en opstartpagina's

Hier is een voorbeeld van hoe de startpagina , zoekmachine en opstartpagina's kunnen worden gewijzigd in het extensiemanifest . Elk domein dat in de instellingen-API wordt gebruikt, moet worden geverifieerd (via Google Search Console) door hetzelfde ontwikkelaarsaccount dat de extensie publiceert. Houd er rekening mee dat als u het eigendom van een domein verifieert (bijvoorbeeld https://example.com), u elk subdomein of elke pagina kunt gebruiken (bijvoorbeeld https://app.example.com of https://example.com/ page.html) binnen uw extensie.

Het gebruik van de instellingen overschrijft de toestemming en vraagt ​​tegelijkertijd om aanvullende mogelijkheden of machtigingen, wat niet strookt met ons beleid voor één doel. Wanneer Chrome detecteert dat een item mogelijk ons ​​beleid voor één doel schendt, wordt er een bevestigingsvenster aan de gebruiker getoond. Extensies die zich beperken tot het wijzigen van slechts één instelling zonder naar extra mogelijkheden of machtigingen te zoeken, krijgen geen bevestigingsvenster.

Dit geldt voor Chrome 107 en hoger.

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

Waarden aanpassen

Waarden in het manifest kunnen op de volgende manieren worden aangepast:

  • Alle waarden van de eigenschappen search_provider , homepage en startup_pages kunnen worden gelokaliseerd met behulp van de chrome.i18n API .
  • Voor externe extensies kunnen de URL-waarden search_provider , homepage en startup_pages worden geparametriseerd met behulp van een registersleutel. Maak een nieuwe registervermelding naast de sleutel "update_url" (zie instructies hier ). De sleutelnaam is "install_parameter" , de waarde is een willekeurige tekenreeks:

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

    Alle exemplaren van de subtekenreeks "__PARAM__" in de manifest-URL's worden vervangen door de waarde "install_parameter" . Als "install_parameter" afwezig is, worden exemplaren van "__PARAM__" verwijderd. Houd er rekening mee dat "__PARAM__" geen deel kan uitmaken van de hostnaam. Het moet voorkomen na de eerste '/' in de URL.

Referentie

Een extensie kan een of meer van de volgende eigenschappen in het manifest overschrijven:

alternate_urls (array van tekenreeksen, optioneel)
Een lijst met URL-patronen die naast search_url.
encoding (tekenreeks, optioneel)
De codering die wordt gebruikt voor zoektermen. Dit is vereist als u prepopulated_id niet instelt.
favicon_url (tekenreeks, optioneel)
Een pictogram-URL voor de zoekmachine. Dit is vereist als u prepopulated_id niet instelt.
homepage (tekenreeks, optioneel)
De nieuwe waarde voor de startpagina.
image_url (tekenreeks, optioneel)
De URL die de zoekmachine gebruikt voor het zoeken naar afbeeldingen. Als dit niet wordt gebruikt, ondersteunt de engine het zoeken naar afbeeldingen niet.
image_url_post_params (tekenreeks, optioneel)
De berichtparameters voor image_url .
is_default (booleaans, vereist)
Specificeert of de zoekmachine standaard moet zijn.
keyword (tekenreeks, optioneel)
Een omnibox-trefwoord voor de zoekmachine. Dit is vereist als u prepopulated_id niet instelt.
name (tekenreeks, optioneel)
Naam van de zoekmachine die aan de gebruiker wordt weergegeven. Dit is vereist als u prepopulated_id niet instelt.
prepopulated_id (geheel getal, optioneel)
Een ID voor de ingebouwde zoekmachine van Chrome.
search_provider (object, optioneel)
Een zoekmachine.
search_url (tekenreeks, vereist)
De zoek-URL die de zoekmachine gebruikt.
search_url_post_params (tekenreeks, optioneel)
De berichtparameters voor search_url .
startup_pages (reeks tekenreeksen, optioneel)
Een array met lengte één die een URL bevat die als opstartpagina moet worden gebruikt.
suggest_url (tekenreeks, optioneel)
De URL die de zoekmachine gebruikt voor suggesties. Als dit niet wordt gebruikt, ondersteunt de engine geen suggesties.
suggest_url_post_params (tekenreeks, optioneel)
De berichtparameters voor suggest_url .