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

En esta página, se describe cómo definir las especificaciones del motor de búsqueda con 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 con un ejemplo simple. A medida que aumentes tu confianza, te recomendamos que comiences a experimentar con varios elementos y atributos. Puedes jugar con los parámetros de configuración en el Panel de control y luego ver la versión XML generada descargada 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 Obligatorias Descripción
CustomSearchEngine Obligatorias Incluye toda la información sobre el motor de búsqueda. Tiene los siguientes atributos:
  • keywords. Especifica una lista (de hasta 100 caracteres) de palabras clave separadas por espacios asociadas con el 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 aumentará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, el 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 el autocompletado de GLOSSARY para tu motor de búsqueda. Los valores permitidos son true o false. Si el valor es true, ten en cuenta que la generación de opciones de autocompletado 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. Puede obtener el código actualizado en la pestaña Obtener código del Panel de control. Solo los motores de búsqueda que realizan búsquedas en sitios incluidos (una colección predeterminada de sitios web) pueden tener consultas autocompletadas.
Title Obligatorias 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 Obligatorias Es el texto descriptivo que aparece en la página de resumen del motor de búsqueda.
Context Obligatorias Contiene información sobre las etiquetas. Incluye los elementos secundarios BackgroundLabels y Facet.
BackgroundLabels Opcional Contenedor de etiquetas utilizadas 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: Es el nombre de la etiqueta.
  • mode. FILTER (promociona o muestra exclusivamente los sitios preferidos) o ELIMINATE (excluye el sitio). Puedes personalizar estas etiquetas como quieras.
LookAndFeel Obligatorias Controla el aspecto de tu motor de búsqueda. Tiene varios atributos y elementos secundarios que se describen en detalle en la página Aspecto.

ImageSearchSettings Opcional

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

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