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

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

  1. Asistencia de llamadas
  2. Qué incluye un Motor de Búsqueda Programable
  3. Cómo funcionan juntos los componentes
  4. Cómo crear un motor de búsqueda
  5. Edita los archivos del Motor de Búsqueda Programable
  6. Cómo elegir el formato correcto

Descripción general

Si el Panel de control no te brinda el nivel de personalización que necesitas, puedes usar el formato XML de Búsqueda Programable, 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 con el Panel de control del Motor de Búsqueda Programable. Una vez que hayas creado el motor de búsqueda, puedes descargar las anotaciones y los archivos XML de contexto desde la página Vista general del Panel de control.

Conceptos básicos de XML

El lenguaje de marcación extensible (XML) es un lenguaje de marcación de uso general. Es texto con etiquetas que puedes leer. Por ejemplo, el formato XML de Búsqueda Programable 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. El archivo XML tiene las siguientes reglas:

  • En formato XML, debes anteponer una declaración 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 etiqueta de cierre (</tag>).
  • Todas tus etiquetas se deben anidar correctamente. No puedes tener un código XML similar a <sandwich><filling> peanut butter</sandwich></filling>. En cambio, debería verse así: <sandwich><filling> peanut butter</filling></sandwich>.
  • El formato XML distingue entre mayúsculas y minúsculas, por lo que debes seguir con atención el uso de mayúsculas y la ortografía de las etiquetas en las instrucciones.
  • Todos los valores de atributos deben encerrarse entre comillas dobles (<element attribute="value">).
  • Todos los atributos se deben definir en la etiqueta de apertura (<element attribute="value">), no en la de cierre ( </element>).

Puedes escribir notas tú mismo 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 dejar de usar temporalmente algún código XML (quizás porque quieras experimentar con ciertos efectos o solucionar problemas). Sin embargo, estos comentarios no se conservan en los archivos que descargues desde el Panel de control. Si quieres conservar los comentarios, debes conservar una copia de los archivos XML comentados incluso después de subirlos al Panel de control.

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

Volver al principio

Qué incluye un Motor de Búsqueda Programable

Un Motor de Búsqueda Programable tiene dos componentes principales, cada uno de los cuales se controla mediante un archivo en formato XML:

No te recomendamos que crees ninguno de estos archivos desde cero. En su lugar, descárgalos 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 escribe una búsqueda que coincide exactamente con uno de tus términos de consulta, la promoción aparece en la parte superior de la página. Puede utilizar las promociones para responder directamente las consultas de los 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 y 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 expande las consultas de los usuarios para incluir variantes del término de búsqueda. Por ejemplo, si el usuario busca "simio", el motor de búsqueda también busca "mono" y "mono". 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 juntos los componentes

El archivo 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 el contexto y las anotaciones. El archivo XML de contexto incluye etiquetas que identifican el motor de búsqueda, y cada anotación enumerada en el XML de las anotaciones está etiquetada 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 mediante el Panel de control, Motor de Búsqueda Programable combina todos tus archivos de anotaciones en uno solo. Los archivos de anotaciones te brindan 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

A continuación, verás 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 se asocia cada sitio (anotación) con una etiqueta:

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

Volver al principio

Cómo crear 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 de tu motor de búsqueda.
  3. Indícale 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 XML, descargue 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 de anotaciones desde 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. Use un editor de texto que pueda controlar las terminaciones de líneas estilo UNIX (WordPad, Emacs y TextMate funcionan; NotePad, no). No importa el nombre que le des al archivo, siempre que lo guardes con la extensión de archivo .xml (por ejemplo, cx_global.xml).
  3. Haz una copia de seguridad del archivo descargado en caso de que la versión editada no funcione como se espera y tengas que volver a la versión anterior.

    Si no realizas una copia y la versión que editaste no funciona correctamente, deberás depurar el archivo o volver a crear el motor de búsqueda. Eso 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 documento de texto Unicode y no como otro formato de archivo.
  5. Sube el archivo en la sección Funciones de búsqueda de la página Descripción general.

Cómo 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 querrás seleccionar un formato que sea más potente y complejo de lo que necesitas ni usar uno que se te pase rápidamente.

Usa la siguiente tabla para elegir el formato adecuado.

Para crear Usa Porque Limitaciones Más información
Uno o pocos motores de búsqueda con una cantidad pequeña de sitios Panel de control Puedes crear rápidamente tu Motor de Búsqueda Programable completando los cuadros de texto en lugar de crear archivos con un editor de texto y subirlos. El Panel de control es muy útil para familiarizarte con el Motor de Búsqueda Programable y crear motores de búsqueda con pocos sitios. Cómo comenzar
Los motores de búsqueda complejos que usan muchos sitios, utilizan 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 las tareas de definición y administración de sitios.

A pesar de que planeas crear tu motor de búsqueda utilizando archivos de contexto y anotaciones, es recomendable que te familiarices con el Panel de control.

 Cuanto más lo personalices, más complejo se volverá. Debes aprender los elementos y atributos de la Búsqueda Programable, que no son difíciles de aprender, pero requieren que dediques un tiempo.

Deberás leer el resto de la guía para desarrolladores, que, por desgracia, no es el material de lectura más interesante.

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

Volver al principio