Cómo crear un Motor de Búsqueda Programable con archivos de configuración

En esta página, se presentan los conceptos básicos detrás de los archivos de configuración del Motor de Búsqueda Programable.

  1. Descripción general
  2. Qué hay en un Motor de Búsqueda Programable
  3. Cómo funcionan en conjunto los componentes
  4. Crea un motor de búsqueda
  5. Cómo editar los archivos del Motor de Búsqueda Programable
  6. Cómo elegir el formato adecuado

Descripción general

Si el Panel de control no te brinda el nivel de personalización que necesitas, considera usar el formato XML de Programmable Search, que te brinda más control, flexibilidad y acceso a funciones más potentes.

Para usar los archivos de configuración del Motor de Búsqueda Programable, primero crea un motor de búsqueda básico en el Panel de control del Motor de Búsqueda Programable. Una vez que hayas creado tu motor de búsqueda, puedes descargar tus anotaciones y archivos XML de contexto desde la página Descripción general del panel de control.

Conceptos básicos de XML

El lenguaje de marcado extensible (o XML) es un lenguaje de marcación de uso general. Es texto con etiquetas que puedes leer. Por ejemplo, el formato XML de Programmable Search incluye las siguientes etiquetas: <Context> </Context> y <LookAndFeel> </LookAndFeel>.

Al igual que con cualquier archivo en formato XML, las especificaciones del Motor de Búsqueda Programable deben seguir la sintaxis XML (<element attribute="value">content</element>) y estar bien formadas. XML tiene las siguientes reglas:

  • XML requiere que antepongas una declaración en formato XML (<?xml version="1.0"?>) a las etiquetas de nivel superior, pero el archivo de configuración del Motor de Búsqueda Programable no lo requiere.
  • Todos tus elementos deben tener una etiqueta de apertura (<tag>) y una de cierre (</tag>).
  • Todas las etiquetas deben estar anidadas de forma correcta. No puedes tener un código XML similar al siguiente: <sandwich><filling> peanut butter</sandwich></filling>. En cambio, debería ser así: <sandwich><filling> peanut butter</filling></sandwich>.
  • XML distingue entre mayúsculas y minúsculas, así que sigue cuidadosamente el uso de mayúsculas y la ortografía de las etiquetas en las instrucciones.
  • Todos los valores de atributos deben estar entre comillas dobles (<element attribute="value">).
  • Todos los atributos deben definirse en la etiqueta de apertura (<element attribute="value">), no en la etiqueta de cierre ( </element>).

Puedes escribir notas por tu cuenta con etiquetas de comentarios (<!-- your comment here -->), y el Motor de Búsqueda Programable no analizará esa línea de texto como código XML. Además de escribir recordatorios o descripciones, puedes usar comentarios para poner de manera temporal algún código XML fuera de servicio (tal vez porque quieres experimentar con ciertos efectos o solucionar problemas). Sin embargo, estos comentarios no se conservan en los archivos que descargas desde el Panel de control. Si quieres conservar los comentarios, debes conservar una copia de tus archivos en formato XML con comentarios, incluso después de subirlos al Panel de control.

Puedes usar un editor de texto simple para crear y editar archivos en formato XML. Solo guarda el archivo de texto con la extensión de archivo .xml (por ejemplo, cse_badminton.xml).

Volver al principio

Qué hay en un Motor de Búsqueda Programable

Un Motor de Búsqueda Programable tiene dos componentes principales, cada uno de los cuales está controlado por un archivo en formato XML:

No te recomendamos que crees cualquiera de estos archivos desde cero. En su lugar, descárgalas desde la página Descripción general del Panel de control.

Además de estos componentes principales, un motor de búsqueda también puede tener los siguientes archivos auxiliares:

  • Promociones: El archivo en formato XML de promociones enumera una serie de resultados personalizados que se activan mediante un conjunto predefinido de términos de búsqueda. Cuando un usuario realiza una búsqueda que coincide exactamente con uno de los términos de la consulta, la promoción aparece en la parte superior de la página. Puede utilizar las promociones para responder directamente las consultas de sus usuarios, dirigirlos a información importante o dirigirlos a páginas web que no se encuentran en la parte superior de la página de resultados pero que son especialmente relevantes. En el Panel de control, las promociones se definen en la pestaña Promociones. Obtén más información sobre las promociones.
  • Sinónimos: El archivo en formato XML de sinónimos amplía las consultas de los usuarios para incluir variantes del término de búsqueda. Por ejemplo, si el usuario busca "simiano", el motor de búsqueda también busca "mono" y "simio". En el Panel de control, los sinónimos se definen en la pestaña Sinónimos. Obtén más información sobre los sinónimos.

Cómo funcionan en conjunto los componentes

El archivo en formato XML de contexto no especifica el archivo de anotaciones que se usará, y el XML de anotaciones no hace referencia al archivo de contexto. El Motor de Búsqueda Programable usa etiquetas para asociar contexto y anotaciones. El archivo XML de contexto incluye etiquetas que identifican el motor de búsqueda, y cada anotación enumerada en el XML de anotaciones se etiqueta con una o más etiquetas que identifican los motores de búsqueda a los que pertenece.Si cambias el nombre de la etiqueta en el archivo de contexto, debes cambiar todas las anotaciones que se etiquetaron con esa etiqueta.

Si bien puedes subir varios archivos de anotaciones, cuando los descargas a través del Panel de control, Motor de Búsqueda Programable combina todos tus archivos de anotaciones en un solo archivo de anotaciones. Los archivos de anotaciones ofrecen la flexibilidad de personalizar el mismo sitio para varios motores de búsqueda. Por ejemplo, un motor de búsqueda podría restringir su búsqueda a algunos sitios, otro podría eliminarlos y otro podría promocionarlos.

context.xml

Este es un ejemplo de un archivo context.xml que contiene etiquetas que identifican el motor de búsqueda al que se aplica:

<BackgroundLabels>
  <Label name="_include_" mode="FILTER"/>
  <Label name="_exclude_" mode="ELIMINATE"/>
<BackgroundLabels>

annotations.xml

A continuación, te mostramos un ejemplo de un archivo de anotaciones que muestra cómo cada sitio (anotación) se asocia con una etiqueta:

<Annotation about="code.google.com/*" score="1">
  <Label name="_include_"/>
</Annotation>

Volver al principio

Crea motores de búsqueda programables avanzados

La creación de motores avanzados implica los siguientes pasos:

  1. Determina el formato adecuado para tus necesidades.
  2. Define las especificaciones para tu motor de búsqueda.
  3. Indica al Motor de Búsqueda Programable qué sitios buscar.
  4. Indícale al Motor de Búsqueda Programable cómo clasificar los resultados de la búsqueda.

Edita los archivos del Motor de Búsqueda Programable

Para trabajar en un archivo en formato XML, descarga la especificación XML desde la página Descripción general del panel de control. No inicies un archivo desde cero. Puedes hacer lo siguiente:

  1. Descarga el archivo de contexto o el archivo de anotaciones de la página Descripción general del Panel de control. Haz clic en el botón Descargar en la sección Funciones de búsqueda.
  2. Usa un editor de texto que pueda manejar terminaciones de línea de estilo UNIX (WordPad, Emacs y TextMate funcionan; NotePad no). El nombre del archivo no es importante, siempre y cuando lo guardes con la extensión .xml (por ejemplo, cx_global.xml).
  3. Haz una copia de seguridad del archivo descargado en caso de que tu versión editada no funcione como se esperaba y tengas que volver a la versión anterior.

    Si no haces una copia y la versión que editaste no funciona correctamente, deberás depurar tu archivo o volver a crear el motor de búsqueda. No es divertido.

  4. Edita el archivo en formato XML y guárdalo. Asegúrate de que tu editor de texto guarde el archivo como un documento de texto Unicode y no como algún otro formato de archivo.
  5. Sube el archivo en la sección Funciones de búsqueda de la página Resumen.

Elegir el formato correcto

Antes de comenzar a crear tu Motor de Búsqueda Programable, determina qué formato se adapta mejor a tus necesidades. No te conviene seleccionar un formato que sea más potente y complejo de lo que necesitas ni usar uno que puedas dejar de lado rápidamente.

Usa la siguiente tabla para elegir el formato adecuado.

Para crear Usar Porque Limitaciones Más información
Uno o pocos motores de búsqueda con un número pequeño de sitios Panel de control Para crear rápidamente tu Motor de Búsqueda Programable, completa los cuadros de texto en lugar de crear archivos con un editor de texto y subirlos. El Panel de control es útil principalmente para familiarizarte con el Motor de Búsqueda Programable y crear motores de búsqueda con pocos sitios. Comenzar
Los motores de búsqueda complejos que usan muchos sitios y usan feeds Archivo de contexto y archivos de anotaciones

Los archivos del Motor de Búsqueda Programable te brindan un mayor nivel de control sobre tus motores de búsqueda y facilitan mucho la tarea de definir y administrar sitios.

Si bien planeas crear tu motor de búsqueda con archivos de contexto y anotaciones, sigue siendo una buena idea que te familiarices con el Panel de control.

 Cuanto más personalizas tu motor de búsqueda, más complejo se vuelve. Debes aprender los elementos y atributos de Programmable Search, que no son difíciles de aprender, pero requieren que inviertas un poco de tiempo.

Tendrás que leer el resto de la guía para desarrolladores, que, desafortunadamente, no es el material de lectura más emocionante.

 Contexto: Definición de las especificaciones de un motor de búsqueda y Anotaciones: selección de sitios

Volver al principio