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 do CustomSearchEngine

Visão geral

Um arquivo de contexto descreve a estrutura do seu 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ê ganhar confiança, comece a testar vários elementos e atributos. É possível testar as configurações no painel de controle e conferir a versão do XML gerada que foi baixada na página Visão geral.

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

<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 do CustomSearchEngine

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

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ços 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 compatíveis para exibição na interface do usuário. Especificar um idioma aprimora os resultados nele, mas não filtra os resultados em outros idiomas. Se não for especificado, o Mecanismo de Pesquisa Programável vai usar o 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 precisa gerar preenchimentos automáticos GLOSSÁRIO para seu mecanismo de pesquisa. Os valores permitidos são true ou false. Se for true, a geração dos preenchimentos automáticos pode levar várias horas. Depois de definir esse valor, você precisa modificar o código da caixa de pesquisa para solicitar preenchimentos automáticos. É possível acessar o código atualizado na guia Obter código no painel de controle. Somente os mecanismos que pesquisam sites incluídos (uma coleção predeterminada de sites) podem ter consultas preenchidas automaticamente.
Title Obrigatório O nome do seu mecanismo de pesquisa. Ele aparece na página inicial e nas páginas de resultados do Mecanismo de Pesquisa Programável.
Description Obrigatório O texto descritivo que aparece na página de visão geral do mecanismo de pesquisa.
Context Obrigatório Contém informações sobre os marcadores. Inclui os elementos filhos BackgroundLabels e Facet.
BackgroundLabels Opcional Recipiente para rótulos usados para promover, incluir ou excluir sites e páginas. Inclui um ou mais elementos Label filhos.
Label Opcional Marcador usado para promover sites ou determinar a inclusão/exclusão de sites. Tem os seguintes atributos:
  • name: O nome do marcador.
  • mode: FILTER (promove ou mostra exclusivamente sites preferidos) ou ELIMINATE (exclui o site). Você pode personalizar esses rótulos como quiser.
LookAndFeel Obrigatório Controla a aparência do mecanismo de pesquisa. Ele 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 de imagens está ativada para esse mecanismo de pesquisa. Os valores permitidos são true ou false.