Anula la configuración de Chrome

Las anulaciones de configuración son una forma de que las extensiones anulen la configuración seleccionada de Chrome. La API es 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 pueden modificar la página principal, el proveedor de búsqueda y las páginas de inicio. en el manifiesto de extensión. Todos los dominios que se usen en la API de Settings se deben verificar (mediante Google Search Console) con la misma cuenta de desarrollador que publica la extensión. Ten en cuenta que si verificar 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/page.html) en tu extensión.

El uso de la configuración anula el permiso y, al mismo tiempo, la solicitud de funciones o permisos adicionales 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 un diálogo de confirmación al usuario. 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",
   ...
}

Personaliza valores

Los valores del 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, se pueden usar los valores de URL search_provider, homepage y startup_pages parametrizarse con una clave de registro. Crea una nueva entrada de registro junto al Clave "update_url" (consulta las instrucciones aquí). El nombre de la clave es "install_parameter", el valor es una cadena arbitraria:

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

    Todos los casos de la subcadena "__PARAM__" en las URLs del manifiesto se sustituirán por el Valor "install_parameter". Si "install_parameter" está ausente, los casos de "__PARAM__" son o quitarse. Ten en cuenta que "__PARAM__" no puede ser parte del nombre de host. Tiene que ocurrir después del primer “/” en la URL.

Referencia

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

alternate_urls (array de cadenas, 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)
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)
La URL que usa el motor de búsqueda para buscar imágenes. Si no se usa, el motor no admite la búsqueda de imágenes.
image_url_post_params (cadena, opcional)
Los parámetros de la publicación de 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)
Un ID del 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 la publicación de search_url.
startup_pages (array de cadenas, opcional)
Array de longitud uno que contiene una URL que se usará como página de inicio.
suggest_url (cadena, opcional)
La URL que usa el motor de búsqueda para las sugerencias. Si no se usa, el motor no admite sugerencias.
suggest_url_post_params (cadena, opcional)
Los parámetros de la publicación de suggest_url.