Override delle impostazioni di Chrome

L'override delle impostazioni consente alle estensioni di eseguire l'override delle 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 la home page, il provider di ricerca e le pagine iniziali possono essere modificate nel file manifest dell'estensione. Tutti i domini utilizzati nell'API Settings devono essere verificati (tramite Google Search Console) dallo stesso account sviluppatore che pubblica l'estensione. Tieni presente che se verifichi 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 dell'autorizzazione di override delle impostazioni e la richiesta di ulteriori funzionalità o autorizzazioni non è coerente con le nostre norme relative al singolo scopo. Quando Chrome rileva che un elemento potrebbe violare le nostre norme relative al singolo scopo, all'utente viene mostrata una finestra di dialogo di conferma. Le estensioni che si limitano a modificare una sola impostazione senza cercare funzionalità o autorizzazioni aggiuntive non ricevono 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 essere parametrizzati utilizzando una chiave del Registro di sistema. Crea una nuova voce del Registro di sistema accanto alla chiave "update_url" (vedi le 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 il valore "install_parameter". Se "install_parameter" non è presente, le occorrenze di "__PARAM__" vengono rimosse. Tieni presente che "__PARAM__" non può far parte del nome host. Deve essere inserito dopo il primo "/" 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 possono essere utilizzati oltre a search_url.
encoding (stringa, facoltativa)
La codifica utilizzata per i termini di ricerca. Questa operazione è obbligatoria se non imposti prepopulated_id.
favicon_url (stringa, facoltativa)
Un URL dell'icona per il motore di ricerca. Questa operazione è obbligatoria se non imposti prepopulated_id.
homepage (stringa, facoltativa)
Il nuovo valore per la home page.
image_url (stringa, facoltativa)
L'URL utilizzato dal motore di ricerca per la ricerca di immagini. Se non viene utilizzata, il motore non supporta la ricerca di immagini.
image_url_post_params (stringa, facoltativa)
I parametri del post per image_url.
is_default (booleano, obbligatorio)
Specifica se il provider di ricerca deve essere predefinito.
keyword (stringa, facoltativa)
Una parola chiave nella omnibox per il motore di ricerca. Questa operazione è obbligatoria se non imposti prepopulated_id.
name (stringa, facoltativa)
Nome del motore di ricerca mostrato all'utente. Questa operazione è obbligatoria 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, facoltativa)
I parametri del post per search_url.
startup_pages (array di stringhe, facoltativo)
Un array di lunghezza uno contenente un URL da utilizzare come pagina iniziale.
suggest_url (stringa, facoltativa)
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, facoltativa)
I parametri del post per suggest_url.