Substituir as configurações do Chrome

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

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

Confira 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 (via webmaster Ferramentas) associadas a esse item na Chrome Web Store. Se você confirmar a propriedade em um domínio (por exemplo, http://example.com), você pode 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",
   ...
}

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 deve ser criada ao lado do "update_url" chave (veja as instruções aqui). O nome do valor é "install_parameter", o valor data é uma string arbitrária:

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

    Todas as ocorrências da substring "__PARAM__" dos URLs do manifesto serão substituídos pelo caractere "install_parameter" . Se "install_parameter" estiver ausente, as ocorrências de "__PARAM__" são removida. O "__PARAM__" não pode fazer parte do nome do host. Ela precisa ocorrer depois que o 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 para o usuário. Isso só poderá ser omitido se prepopulated_id estiver definido.

    string Palavra-chave (opcional)

    Palavra-chave da omnibox para o mecanismo de pesquisa. Isso só poderá ser omitido se prepopulated_id estiver definido.

    string (opcional) favicon_url

    Um URL de ícone para o mecanismo de pesquisa. Só pode ser omitido se prepopulated_id está definido.

    string search_url

    Um URL de pesquisa usado pelo mecanismo de pesquisa.

    string Codificação (opcional)

    Codificação do termo de pesquisa. Só pode ser omitido se prepopulated_id for definido.

    string (opcional) suggest_url

    Se omitido, esse mecanismo não oferece suporte a sugestões.

    string (opcional) image_url

    Se omitido, esse mecanismo não oferece suporte à 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

    A string dos parâmetros de postagem em "suggest_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é-preenchido_id

    Um ID do mecanismo de pesquisa integrado no Chrome.

    booleano is_default

    Especifica se o provedor de pesquisa será padrão.

  • startup_pages (matriz de string): opcional

    Uma matriz de comprimento um que contém um URL a ser usado como página de inicialização.