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.
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.