Anula la configuración de Chrome

La anulación de parámetros de configuración permite que las extensiones anulen los parámetros de Chrome seleccionados. La API está disponible en Windows y Mac en todas las versiones actuales de Chrome.

Página principal, proveedor de búsqueda y páginas de inicio

Este es un ejemplo de cómo se puede modificar la página principal, el proveedor de búsqueda y las páginas de inicio en el manifiesto de extensión. Cualquier dominio que se use en la API de Settings debe estar verificado (mediante Google Search Console) por la misma cuenta de desarrollador que publica la extensión. Ten en cuenta que, si verificas la propiedad de un dominio (por ejemplo, https://example.com), puedes usar cualquier subdominio o página (por ejemplo, https://app.example.com o https://example.com/página.html) dentro de tu extensión.

El uso de la configuración anula el permiso y, al mismo tiempo, solicita cualquier función o permiso adicional no es coherente con nuestra política de propósito único. Cuando Chrome detecta que un elemento podría infringir nuestra política de propósito único, se muestra al usuario un diálogo de confirmación. Las extensiones que se limitan a modificar un solo parámetro de configuración sin buscar capacidades o permisos adicionales no reciben un diálogo de confirmación.

Esto se aplica a Chrome 107 y versiones posteriores.

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

Cómo personalizar valores

Los valores en el manifiesto se pueden personalizar de las siguientes maneras:

  • Todos los valores de las propiedades search_provider, homepage y startup_pages se pueden localizar con la API de chrome.i18n.

  • En el caso de las extensiones externas, los valores de URL search_provider, homepage y startup_pages se pueden parametrizar mediante una clave de registro. Crea una nueva entrada de registro junto a la clave "update_url" (consulta las instrucciones aquí). El nombre de la clave es "install_parameter" y el valor es una string arbitraria:

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

    Todos los casos de la substring "__PARAM__" en las URLs del manifiesto se reemplazarán por el valor "install_parameter". Si "install_parameter" está ausente, se quitan los casos de "__PARAM__". Ten en cuenta que "__PARAM__" no puede formar parte del nombre de host. Debe ocurrir después de la primera “/” en la URL.

Reference

Una extensión puede anular una o más de las siguientes propiedades en el manifiesto:

alternate_urls (arreglo de strings, opcional)
Una lista de patrones de URL que se pueden usar además de search_url.
encoding (cadena, opcional)
La codificación que se usa para los términos de búsqueda. Esto es obligatorio si no configuras prepopulated_id.
favicon_url (cadena, opcional)
Es una URL de ícono para el motor de búsqueda. Esto es obligatorio si no configuras prepopulated_id.
homepage (cadena, opcional)
El nuevo valor de la página principal.
image_url (cadena, opcional)
Es la URL que el motor de búsqueda usa para la búsqueda de imágenes. Si no se usa, el motor no admite la búsqueda con imágenes.
image_url_post_params (cadena, opcional)
Los parámetros de publicación para image_url.
is_default (booleano, obligatorio)
Especifica si el proveedor de búsqueda debe ser el predeterminado.
keyword (cadena, opcional)
Una palabra clave del cuadro multifunción para el motor de búsqueda. Esto es obligatorio si no configuras prepopulated_id.
name (cadena, opcional)
Es el nombre del motor de búsqueda que se muestra al usuario. Esto es obligatorio si no configuras prepopulated_id.
prepopulated_id (número entero, opcional)
Es un ID para el motor de búsqueda integrado de Chrome.
search_provider (objeto, opcional)
Un motor de búsqueda
search_url (cadena, obligatoria)
La URL de búsqueda que usa el motor de búsqueda.
search_url_post_params (cadena, opcional)
Los parámetros de publicación para search_url.
startup_pages (arreglo de strings, opcional)
Un array de longitud que contiene una URL para usar como página de inicio.
suggest_url (cadena, opcional)
La URL que el motor de búsqueda usa para obtener sugerencias. Si no se usa, el motor no admite sugerencias.
suggest_url_post_params (cadena, opcional)
Los parámetros de publicación para suggest_url.