Cette page a été traduite par l'API Cloud Translation.

Remplacement des paramètres Chrome

Les paramètres de remplacement permettent aux extensions de remplacer les paramètres Chrome sélectionnés. L'API est disponible sur Windows et Mac dans toutes les versions actuelles de Chrome.

Page d'accueil, moteur de recherche et pages de démarrage

Voici un exemple de modification de la page d'accueil, du moteur de recherche et des pages de démarrage dans le fichier manifeste de l'extension. Tout domaine utilisé dans l'API des paramètres doit être validé (via Google Search Console) par le compte de développeur qui publie l'extension. Notez que si vous validez la propriété d'un domaine (par exemple, https://example.com), vous pouvez utiliser n'importe quel sous-domaine ou page (par exemple, https://app.example.com ou https://example.com/page.html) dans votre extension.

L'utilisation des paramètres remplace l'autorisation tout en demandant également des fonctionnalités ou des autorisations supplémentaires est contraire à notre règlement sur l'objectif unique. Lorsque Chrome détecte qu'un élément est susceptible d'enfreindre notre règlement sur l'objectif unique, une boîte de dialogue de confirmation s'affiche. Les extensions qui se limitent à ne modifier qu'un seul paramètre sans rechercher de fonctionnalités ou d'autorisations supplémentaires ne s'affichent pas de boîte de dialogue de confirmation.

Cela s'applique à Chrome 107 et versions ultérieures.

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

Personnaliser les valeurs

Les valeurs du fichier manifeste peuvent être personnalisées comme suit:

Toutes les valeurs des propriétés search_provider, homepage et startup_pages peuvent être localisées à l'aide de l'API chrome.i18n.
Pour les extensions externes, les valeurs d'URL search_provider, homepage et startup_pages peuvent être paramétrées à l'aide d'une clé de registre. Créez une entrée de registre à côté de la clé "update_url" (voir les instructions sur cette page). Le nom de la clé est "install_parameter", la valeur est une chaîne arbitraire:
```
{
  "update_url": "https://clients2.google.com/service/update2/crx",
  "install_parameter": "Value"
}
```
Toutes les occurrences de la sous-chaîne "__PARAM__" dans les URL du fichier manifeste seront remplacées par la valeur "install_parameter". Si "install_parameter" est absent, les occurrences de "__PARAM__" sont supprimées. Notez que "__PARAM__" ne peut pas faire partie du nom d'hôte. Il doit apparaître après le premier caractère "/" dans l'URL.

Reference

Une extension peut remplacer une ou plusieurs des propriétés suivantes dans le fichier manifeste:

alternate_urls (tableau de chaînes, facultatif): Liste de formats d'URL pouvant être utilisés en plus de search_url.
encoding (chaîne, facultative): Encodage utilisé pour les termes de recherche. Cette étape est obligatoire si vous ne définissez pas prepopulated_id.
favicon_url (chaîne, facultative): URL d'icône pour le moteur de recherche. Cette étape est obligatoire si vous ne définissez pas prepopulated_id.
homepage (chaîne, facultative): Nouvelle valeur de la page d'accueil.
image_url (chaîne, facultative): URL que le moteur de recherche utilise pour la recherche d'images. Si vous ne l'utilisez pas, le moteur n'est pas compatible avec la recherche d'images.
image_url_post_params (chaîne, facultative): Paramètres des posts pour image_url.
is_default (booléen, obligatoire): Indique si le moteur de recherche doit être utilisé par défaut.
keyword (chaîne, facultative): Mot clé de l'omnibox pour le moteur de recherche. Cette étape est obligatoire si vous ne définissez pas prepopulated_id.
name (chaîne, facultative): Nom du moteur de recherche présenté à l'utilisateur. Cette étape est obligatoire si vous ne définissez pas prepopulated_id.
prepopulated_id (entier, facultatif): ID du moteur de recherche intégré de Chrome.
search_provider (objet, facultatif): Un moteur de recherche.
search_url (chaîne, obligatoire): URL de recherche utilisée par le moteur de recherche.
search_url_post_params (chaîne, facultative): Paramètres des posts pour search_url.
startup_pages (tableau de chaînes, facultatif): Tableau de longueur contenant une URL à utiliser comme page de démarrage.
suggest_url (chaîne, facultative): URL que le moteur de recherche utilise pour les suggestions. Si cet attribut n'est pas utilisé, le moteur n'accepte pas les suggestions.
suggest_url_post_params (chaîne, facultative): Paramètres des posts pour suggest_url.