Contexto: como definir um Mecanismo de Pesquisa Programável

Esta página descreve como definir as especificações do seu mecanismo de pesquisa usando um arquivo de contexto.

  1. Visão geral
  2. Elementos CustomSearchEngine

Informações gerais

O arquivo de contexto descreve a estrutura do mecanismo de pesquisa e define o comportamento dele. A melhor maneira de começar a aprender sobre arquivos de contexto é com um exemplo simples. À medida que você ganha confiança, pode começar a testar vários elementos e atributos. Você pode testar as configurações no painel de controle e visualizar a versão do XML gerada por download na página Visão geral.

O código a seguir descreve um mecanismo de pesquisa para mudanças climáticas. A pesquisa de imagens está ativada neste mecanismo.

<CustomSearchEngine keywords="climate &quot;global warming&quot; &quot;greenhouse gases&quot;"
                    language="en">
  <Title>RealClimate</Title>
  <Description>Science behind global warming and climate change.</Description>
  <Context>
    <BackgroundLabels>
      <Label name="_include_" mode="FILTER"/>
      <Label name="_exclude_" mode="ELIMINATE"/>
    </BackgroundLabels>
  </Context>
  <LookAndFeel/>
  <ImageSearchSettings enable="true"/>
</CustomSearchEngine>

Elementos CustomSearchEngine

Um arquivo de contexto básico inclui os elementos principais e filhos a seguir.

Elemento Obrigatório Descrição
CustomSearchEngine Obrigatório Inclui todas as informações sobre o mecanismo de pesquisa. Tem os seguintes atributos:
  • keywords: especifica uma lista (de até 100 caracteres) de palavras-chave separadas por espaço associadas ao mecanismo de pesquisa. Se não for especificado, o Mecanismo de Pesquisa Programável vai usar um valor vazio.
  • language. Especifica um dos idiomas suportados que serão exibidos na interface do usuário. Especificar um idioma aumentará os resultados nesse idioma, mas não filtrará os resultados em outros idiomas. Se não for especificado, o Mecanismo de Pesquisa Programável usará en (inglês). Se o valor for nulo, o Mecanismo de Pesquisa Programável vai usar o idioma da localidade do usuário.
  • autocompletions. Indica se o Mecanismo de Pesquisa Programável deve gerar preenchimentos automáticos GLOSSÁRIOS para seu mecanismo. Os valores permitidos são true ou false. Se for true, a geração de preenchimentos automáticos poderá levar várias horas. Depois de definir esse valor, modifique o código da caixa de pesquisa para solicitar preenchimentos automáticos. Você pode obter o código atualizado na guia Obter código do painel de controle. Somente os mecanismos de pesquisa que incluíram sites (um conjunto predeterminado de sites) podem ter consultas de preenchimento automático.
Title Obrigatório O nome do seu mecanismo de pesquisa. Ele aparece na página inicial do Mecanismo de Pesquisa Programável e nas páginas de resultados.
Description Obrigatório O texto descritivo que aparece na página de visão geral do mecanismo de pesquisa.
Context Obrigatório Mantém informações sobre marcadores. Inclui os elementos filhos BackgroundLabels e Facet.
BackgroundLabels Opcional Contêiner dos rótulos usados para promover, incluir ou excluir sites e páginas. Inclui um ou mais elementos Label filhos.
Label Opcional Rótulo usado para promover sites ou determinar a inclusão/exclusão de sites. Tem os seguintes atributos:
  • name. O nome do rótulo.
  • mode. FILTER (promove ou mostra exclusivamente sites preferidos) ou ELIMINATE (exclui site). Você pode personalizar esses rótulos como quiser.
LookAndFeel Obrigatório Controla a aparência do seu mecanismo de pesquisa. Ela tem vários atributos e elementos filhos que são descritos em detalhes na página Aparência.

ImageSearchSettings Opcional

Especifica se a pesquisa por imagens está ativada. Tem os seguintes atributos:

  • enable. Especifica se a pesquisa por imagens está ativada para esse mecanismo. Os valores permitidos são true ou false.