Substituir as configurações do Chrome

As substituições de configurações são uma forma de as extensões modificarem as configurações selecionadas do Chrome. A API está disponível no Windows em todas as versões atuais do Chrome e no Chrome 56 e versões mais recentes para Mac.

Página inicial, provedor de pesquisa e páginas de inicialização

Veja um exemplo de como a página inicial, o provedor de pesquisa e as páginas de inicialização podem ser modificadas no manifesto da extensão. Os sites usados na API Settings precisam ser verificados (pelas Ferramentas do Google para webmasters) como se estivessem associados a esse item na Chrome Web Store. Se você verificar a propriedade de um domínio (por exemplo, http://example.com), poderá usar qualquer subdomínio ou página (por exemplo, http://app.example.com ou http://example.com/page.html) na sua extensão.

{
  "name": "My extension",
  ...
  "chrome_settings_overrides": {
    "homepage": "http://www.homepage.com",
    "search_provider": {
        "name": "name.__MSG_url_domain__",
        "keyword": "keyword.__MSG_url_domain__",
        "search_url": "http://www.foo.__MSG_url_domain__/s?q={searchTerms}",
        "favicon_url": "http://www.foo.__MSG_url_domain__/favicon.ico",
        "suggest_url": "http://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
        "instant_url": "http://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
        "image_url": "http://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": [
          "http://www.moo.__MSG_url_domain__/s?q={searchTerms}",
          "http://www.noo.__MSG_url_domain__/s?q={searchTerms}"
        ],
        "encoding": "UTF-8",
        "is_default": true
    },
    "startup_pages": ["http://www.startup.com"]
   },
   "default_locale": "de",
   ...
}

Como personalizar valores

Os valores no manifesto podem ser personalizados das seguintes maneiras:

• Todos os valores das propriedades search_provider, homepage e startup_pages podem ser localizados usando a API chrome.i18n.

• Para extensões externas, os valores de URL search_provider, homepage e startup_pages podem ser parametrizados usando uma chave de registro. Uma nova entrada de registro precisa ser criada ao lado da chave "update_url". Consulte as instruções aqui. O nome do valor é "install_parameter", os dados do valor são uma string arbitrária:

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

  Todas as ocorrências da substring "__PARAM__" nos URLs do manifesto serão substituídas pelo valor "install_parameter". Se "install_parameter" estiver ausente, as ocorrências de "__PARAM__" serão removidas. "__PARAM__" não pode fazer parte do nome do host. Ele precisa ocorrer depois do primeiro "/" no URL.

Referência

Uma extensão pode substituir uma ou mais das seguintes propriedades no manifesto:

• homepage (string): opcional

  Novo valor para a página inicial.

• search_provider (objeto): opcional

  Um mecanismo de pesquisa

  Tipo	Atributo	Descrição
  string	Nome (opcional)	Nome do mecanismo de pesquisa exibido ao usuário. Só pode ser omitido se prepopulated_id estiver definido.
  string	Palavra-chave (opcional)	Palavra-chave da omnibox para o mecanismo de pesquisa. Só pode ser omitido se prepopulated_id estiver definido.
  string	(opcional) favicon_url	URL do ícone do mecanismo de pesquisa. Só pode ser omitido se prepopulated_id estiver definido.
  string	search_url	Um URL usado pelo mecanismo de pesquisa.
  string	Codificação (opcional)	Codificação do termo de pesquisa. Só pode ser omitido se prepopulated_id estiver definido.
  string	URL de sugestão (opcional)	Se omitido, o mecanismo não aceita sugestões.
  string	(opcional) image_url	Se omitido, o mecanismo não aceita a pesquisa de imagens.
  string	(opcional) search_url_post_params	A string de parâmetros de postagem para search_url
  string	(opcional)suggest_url_post_params (em inglês)	A string de parâmetros de postagem parasuggest_url
  string	(opcional) image_url_post_params	A string dos parâmetros de postagem para image_url
  matriz de string	(opcional)alternate_urls	Uma lista de padrões de URL que podem ser usados, além de |search_url|.
  número inteiro	(opcional) pré-filled_id	Um ID do mecanismo de pesquisa integrado no Chrome.
  boolean	is_default	Especifica se o provedor de pesquisa deve ser padrão.

• startup_pages (matriz de string): opcional

  Uma matriz de comprimento um contendo um URL a ser usado como a página de inicialização.