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

Remplacement des paramètres Chrome

Le remplacement des paramètres permet aux extensions de remplacer les paramètres Chrome sélectionnés. L'API est disponible pour Windows et Mac dans toutes les versions actuelles de Chrome.

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

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

Notre règlement relatif à l'objectif unique ne respecte pas notre règlement relatif à l'objectif unique lorsque vous utilisez ces paramètres pour remplacer l'autorisation tout en demandant d'autres fonctionnalités ou autorisations. Lorsque Chrome détecte qu'un élément est susceptible d'enfreindre notre règlement d'objectif unique, une boîte de dialogue de confirmation s'affiche. Les extensions qui se limitent à modifier un seul paramètre sans demander de fonctionnalités ou d'autorisations supplémentaires n'ont pas de boîte de dialogue de confirmation.

Cela s'applique à Chrome 107 et aux 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és à l'aide d'une clé de registre. Créez une entrée de registre à côté de Clé "update_url" (pour consulter les instructions, cliquez ici). 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 le Valeur "install_parameter". Si "install_parameter" est absent, les occurrences de "__PARAM__" sont supprimés. Notez que "__PARAM__" ne peut pas faire partie du nom d'hôte. Elle doit avoir lieu après le premier "/" dans l'URL.

Référence

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

alternate_urls (tableau de chaînes, facultatif): Liste des formats d'URL pouvant être utilisés en plus de search_url.
encoding (chaîne, facultatif): Encodage utilisé pour les termes de recherche. Cette étape est obligatoire si vous ne définissez pas prepopulated_id.
favicon_url (chaîne, facultatif): URL d'icône pour le moteur de recherche. Cette étape est obligatoire si vous ne définissez pas prepopulated_id.
homepage (chaîne, facultatif): Nouvelle valeur de la page d'accueil.
image_url (chaîne, facultatif): URL utilisée par le moteur de recherche pour la recherche d'images. Si vous n'utilisez pas cette option, le moteur n'accepte pas la recherche d'images.
image_url_post_params (chaîne, facultatif): Paramètres du post pour image_url.
is_default (booléen, obligatoire): Spécifie si le moteur de recherche doit être défini par défaut.
keyword (chaîne, facultatif): Mot clé omnibox pour le moteur de recherche. Cette étape est obligatoire si vous ne définissez pas prepopulated_id.
name (chaîne, facultatif): 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): Identifiant 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, facultatif): Paramètres du post pour search_url.
startup_pages (tableau de chaînes, facultatif): Tableau de longueur 1 contenant une URL à utiliser comme page de démarrage.
suggest_url (chaîne, facultatif): URL utilisée par le moteur de recherche pour les suggestions. Si vous ne l'utilisez pas, le moteur n'accepte pas les suggestions.
suggest_url_post_params (chaîne, facultatif): Paramètres du post pour suggest_url.