Override delle impostazioni di Chrome

L'override delle impostazioni consente alle estensioni di sostituire le impostazioni di Chrome selezionate. L'API è disponibile su Windows e Mac in tutte le versioni attuali di Chrome.

Home page, provider di ricerca e pagine iniziali

Ecco un esempio di come è possibile modificare la home page, il provider di ricerca e le pagine iniziali nel manifest dell'estensione. Qualsiasi dominio utilizzato nell'API Settings deve essere verificato (tramite Google Search Console) dallo stesso account sviluppatore che pubblica l'estensione. Tieni presente che verificare la proprietà di un dominio (ad esempio https://example.com), puoi utilizzare qualsiasi sottodominio o pagina (ad esempio, https://app.example.com o https://example.com/page.html) all'interno dell'estensione.

L'uso delle impostazioni sostituisce l'autorizzazione, ma richiede anche autorizzazioni o funzionalità aggiuntive non è coerente con le nostre norme relative a un unico scopo. Quando Chrome rileva che un elemento potrebbe violare le nostre norme relative ai singoli scopi, all'utente viene mostrata una finestra di dialogo di conferma. Per le estensioni che si limitano a modificare una singola impostazione senza cercare ulteriori funzionalità o autorizzazioni non viene visualizzata una finestra di dialogo di conferma.

Questo vale per Chrome 107 e versioni successive.

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

Personalizzazione dei valori

I valori nel file manifest possono essere personalizzati nei seguenti modi:

  • Tutti i valori delle proprietà search_provider, homepage e startup_pages possono essere localizzati utilizzando l'API chrome.i18n.

  • Per le estensioni esterne, i valori URL search_provider, homepage e startup_pages possono parametrizzate usando una chiave di registro. Crea una nuova voce di registro accanto Chiave "update_url" (vedi istruzioni qui). Il nome della chiave è "install_parameter", il valore è una stringa arbitraria:

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

    Tutte le occorrenze della sottostringa "__PARAM__" negli URL manifest verranno sostituite con Valore "install_parameter". Se "install_parameter" non è presente, le occorrenze di "__PARAM__" sono rimosso. Tieni presente che "__PARAM__" non può far parte del nome host. Deve verificarsi dopo prima "/" nell'URL.

Riferimento

Un'estensione può sostituire una o più delle seguenti proprietà nel file manifest:

alternate_urls (array di stringhe, facoltativo)
Un elenco di pattern URL che è possibile utilizzare in aggiunta a search_url.
encoding (stringa, facoltativo)
La codifica utilizzata per i termini di ricerca. Questa operazione è necessaria se non imposti prepopulated_id.
favicon_url (stringa, facoltativo)
Un URL icona per il motore di ricerca. Questa operazione è necessaria se non imposti prepopulated_id.
homepage (stringa, facoltativo)
Il nuovo valore per la home page.
image_url (stringa, facoltativo)
L'URL utilizzato dal motore di ricerca per la ricerca immagini. Se non viene utilizzata, il motore non supporta la ricerca immagini.
image_url_post_params (stringa, facoltativo)
I parametri post per image_url.
is_default (booleano, obbligatorio)
Specifica se il provider di ricerca deve essere predefinito.
keyword (stringa, facoltativo)
Una parola chiave omnibox per il motore di ricerca. Questa operazione è necessaria se non imposti prepopulated_id.
name (stringa, facoltativo)
Nome del motore di ricerca mostrato all'utente. Questa operazione è necessaria se non imposti prepopulated_id.
prepopulated_id (numero intero, facoltativo)
Un ID per il motore di ricerca integrato di Chrome.
search_provider (oggetto, facoltativo)
Un motore di ricerca.
search_url (stringa, obbligatoria)
L'URL di ricerca utilizzato dal motore di ricerca.
search_url_post_params (stringa, facoltativo)
I parametri post per search_url.
startup_pages (array di stringhe, facoltativo)
Un array di uno di lunghezza diversa contenente un URL da utilizzare come pagina iniziale.
suggest_url (stringa, facoltativo)
L'URL utilizzato dal motore di ricerca per i suggerimenti. Se non viene utilizzata, il motore non supporta i suggerimenti.
suggest_url_post_params (stringa, facoltativo)
I parametri post per suggest_url.