Contexto: Cómo definir un Motor de Búsqueda Programable

En esta página, se describe cómo definir las especificaciones de tu motor de búsqueda mediante un archivo de contexto.

  1. Descripción general
  2. Elementos de CustomSearchEngine

Descripción general

Un archivo de contexto describe la estructura de tu motor de búsqueda y define su comportamiento. La mejor manera de comenzar a aprender sobre los archivos de contexto es viendo un ejemplo simple. A medida que aumentes tu confianza, es posible que desees comenzar a experimentar con diversos elementos y atributos. Puedes usar los parámetros de configuración en el panel de control y, luego, ver la versión XML generada que se descargó desde la página Descripción general.

El siguiente código describe un motor de búsqueda sobre el cambio climático. Ten en cuenta que este motor de búsqueda tiene habilitada la búsqueda con imágenes.

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

Un archivo de contexto básico incluye los siguientes elementos principales y secundarios.

Elemento Obligatorio Descripción
CustomSearchEngine Obligatorio Incluye toda la información sobre el motor de búsqueda. Tiene los siguientes atributos:
  • keywords Especifica una lista (hasta 100 caracteres) de palabras clave separadas por espacios asociadas al motor de búsqueda. Si no se especifica, el Motor de Búsqueda Programable usará un valor vacío.
  • language Especifica uno de los idiomas compatibles que se mostrarán en la interfaz de usuario. Si especificas un idioma, se mejorarán los resultados en ese idioma, pero no se filtrarán los resultados en otros idiomas. Si no se especifica, el Motor de Búsqueda Programable usará en (inglés). Si el valor es nulo, Motor de Búsqueda Programable usará el idioma de la configuración regional de tu usuario.
  • autocompletions Indica si el Motor de Búsqueda Programable debe generar opciones de autocompletado GLOSARIO para tu motor de búsqueda. Los valores permitidos son true o false. Si es true, ten en cuenta que la generación de autocompletados puede tardar varias horas. Después de establecer este valor, debes modificar el código de tu cuadro de búsqueda para solicitar el autocompletado. Puedes obtener el código actualizado en la pestaña Obtener código en el Panel de control. Solo los motores de búsqueda que buscan sitios incluidos (una colección predeterminada de sitios web) pueden tener consultas autocompletadas.
Title Obligatorio El nombre de tu motor de búsqueda. Aparece en la página principal del Motor de Búsqueda Programable y en las páginas de resultados.
Description Obligatorio Es el texto descriptivo que aparece en la página de resumen de tu motor de búsqueda.
Context Obligatorio Contiene información sobre las etiquetas. Incluye los elementos secundarios BackgroundLabels y Facet.
BackgroundLabels Opcional Contenedor de etiquetas que se usan para promocionar, incluir o excluir sitios y páginas. Incluye uno o más elementos secundarios Label.
Label Opcional Etiqueta que se usa para promocionar sitios o determinar su inclusión o exclusión. Tiene los siguientes atributos:
  • name El nombre de la etiqueta.
  • mode FILTER (promociona o muestra exclusivamente los sitios preferidos) o ELIMINATE (excluye el sitio). Puedes personalizar estas etiquetas como desees.
LookAndFeel Obligatorio Controla el aspecto de tu motor de búsqueda. Tiene varios atributos y elementos secundarios que se describen en detalle en la página Diseño.

ImageSearchSettings Opcional

Especifica si la búsqueda con imágenes está habilitada. Tiene los siguientes atributos:

  • enable Especifica si la búsqueda con imágenes está habilitada para este motor de búsqueda. Los valores permitidos son true o false.