Motores de b�squeda personalizados vinculados

En un CSE vinculado, la especificaci�n del motor de b�squeda se aloja en su sitio web. En un CSE almacenado en Google, la especificaci�n se almacena en Google.

Con un motor de b�squeda personalizado (CSE) almacenado de Google tradicional, para crear el CSE puedes acceder y utilizar el asistente o crear un archivo XML y subirlo a Google (a trav�s de la ficha de opciones avanzadas). El c�digo del cuadro de b�squeda que utilizas hace referencia a esta especificaci�n almacenada en Google con el par�metro "cx". Para cambiar cualquier aspecto del CSE, tienes que utilizar el panel de control o subir la nueva especificaci�n XML. Esto implica varias limitaciones:

La creaci�n y el mantenimiento de un CSE es un proceso manual.
Es dif�cil crear una gran cantidad de CSE, pongamos uno para cada uno de sus usuarios, o uno un poco diferente para cada una de las p�ginas.
Es dif�cil utilizar otras fuentes de datos como iCal, RSS, Google Base, etc. para crear CSE program�ticamente.

Los motores de b�squeda personalizados vinculados superan estas limitaciones de los motores de b�squeda personalizados (CSE, Custom Search Engine) almacenados de Google, ya que te permiten alojar la especificaci�n del CSE en los sitios web e incluir la URL de esa especificaci�n en la solicitud de b�squeda del CSE. Google recupera la especificaci�n del CSE del sitio web cuando los usuarios buscan en el motor de b�squeda personalizado. Este sistema presenta importantes ventajas:

Puede convertir f�cilmente sus datos en un Motor de b�squeda personalizado.
Puede generar autom�ticamente cualquier cantidad de CSE, cada uno para un usuario particular, para una p�gina particular, para una hora del d�a, etc. De hecho, puede generar CSE seg�n la demanda, en respuesta a una consulta de usuario o a una p�gina en su sitio desde donde un usuario busca. Le proporcionamos varias herramientas interesantes, como la creaci�n de un CSE vinculado a partir de los enlaces de una p�gina, que usted puede utilizar.
Puede actualizar f�cilmente sus definiciones de CSE vinculados sin tener que enviar datos a Google.
No hay l�mites de anotaciones globales por usuario.

Ahora puede beneficiarse al m�ximo de sus ideas para generar CSE din�micamente. Las herramientas que proporcionamos nosotros y terceros hacen que sea m�s f�cil mantener su CSE en sincronizaci�n con su propio sitio web y los de otros. Algunas fuentes de datos interesantes que podr�a utilizar para crear CSE son feeds iCal, sus registros referenciales y sus marcadores de usuarios o historial de exploraci�n. Incluso podr�a cambiar el dise�o de su CSE como respuesta a la salud o al tr�fico de su sitio web. Sea creativo, �las posibilidades son ilimitadas!

La especificaci�n CSE puede referirse a uno o m�s archivos de anotaci�n externos. Esto facilita compartir anotaciones entre CSE.

No obstante, ten en cuenta que algunas de las funciones de los CSE almacenados de Google, como las colaboraciones y el marcador de Google, no funcionan con los CSE vinculados. Si ya dispones de anotaciones almacenadas en Google, puedes descargarlas e incluirlas en tu CSE vinculado. Para obtener m�s informaci�n, consulta Transici�n de un CSE almacenado en Google a un CSE vinculado. Ten en cuenta tambi�n que los CSE vinculados son siempre gratuitos y admiten anuncios; el mecanismo de los CSE vinculados no se puede utilizar para alojar especificaciones de CSE para Google Site Search.

Ejemplo de CSE vinculado

A continuaci�n se muestra un sencillo ejemplo de la utilizaci�n de un motor de b�squeda personalizado vinculado cuya especificaci�n se encuentra en http://www.guha.com/cref_cse.xml. La especificaci�n del CSE incluye los sitios en los que se debe buscar, la apariencia de los resultados, etc. A continuaci�n se muestra el c�digo del cuadro de b�squeda que utiliza esta especificaci�n de CSE (observa el par�metro "cref").

<!-- Google CSE Search Box Begins  -->
<!-- Use of this code assumes agreement with the Google Custom Search Terms of Service. -->
<!-- The terms of service are available at http://www.google.com/cse/docs/tos.html -->
<form id="cref" action="http://www.google.com/cse">
  <input type="hidden" name="cref" value="http://www.guha.com/cref_cse.xml" />
  <input type="text" name="q" size="40" />
  <input type="submit" name="sa" value="Search" />
</form>
<script type="text/javascript" src="'/cse'/brand'?form='cref" ></script>
<!-- Google CSE Search Box Ends -->

Par�metros de formulario importantes:

cref: la URL de su especificaci�n de CSE
q: El cuadro de consultas

�Pruebe este motor de b�squeda aqu�!

Tenga en cuenta que este cuadro de b�squeda podr�a estar en el mismo sitio que el archivo de especificaci�n CSE, en varias p�ginas en dicho sitio o incluso en otro sitio.

La primera vez que un usuario env�e una consulta, extraeremos la especificaci�n de CSE y la utilizaremos para procesar la consulta. Tambi�n almacenaremos la especificaci�n de CSE en la memoria cach� y la actualizaremos peri�dicamente para que no tengas que preocuparte de incluir las solicitudes de la especificaci�n de CSE de Google cada vez que un usuario env�e una consulta. Si cambias la especificaci�n de tu motor de b�squeda personalizado (CSE) vinculado y necesitas actualizarlo inmediatamente, s�lo tienes que acceder a la p�gina de actualizaci�n de CSE vinculado e introducir la URL de tu especificaci�n de CSE.

Ejemplo de un CSE vinculado con resultados alojados en su sitio

Como con un Motor de b�squeda personalizado est�ndar, tambi�n puede utilizar un CSE vinculado para alojar resultados en su sitio. Para hacerlo necesita dos fragmentos de c�digo, uno para el cuadro de b�squeda y otro para los resultados de b�squeda. El c�digo del cuadro de b�squeda es similar al del ejemplo anterior, con algunos cambios:

<!-- Google CSE Search Box Begins  -->
<!-- Use of this code assumes agreement with the Google Custom Search Terms of Service. -->
<!-- The terms of service are available at http://www.google.com/cse/docs/tos.html -->
<form id="cref_iframe" action="http://www.guha.com/results.html">
  <input type="hidden" name="cref" value="http://www.guha.com/cref_cse.xml" />
  <input type="hidden" name="cof" value="FORID:9" />
  <input type="text" name="q" size="40" />
  <input type="submit" name="sa" value="Search" />
</form>
<script type="text/javascript" src="'/cse'/brand'?form='cref_iframe" ></script>
<!-- Google CSE Search Box Ends -->

Par�metros de formulario importantes:

campo acci�n: La URL en la que desea alojar los resultados (en este ejemplo utilizamos http://www.guha.com/results.html)
cref: la URL de su especificaci�n de CSE
cof: FORID:9, FORID:10 o FORID:11. Especifica el formato de anuncio que quieres mostrar. Consulta la especificaci�n de CSE para obtener m�s informaci�n.
q: El cuadro de consultas

En la URL indicada en el campo acci�n anterior, deber� colocar este c�digo donde desee que aparezcan los resultados de b�squeda:

<div id="cse-search-results"></div>
<script type="text/javascript">
  var googleSearchIframeName = "cse-search-results";
  var googleSearchFormName = "cse-search-box";
  var googleSearchFrameWidth = 600;
  var googleSearchDomain = "www.google.com";
  var googleSearchPath = "/cse";
</script>
<script type="text/javascript" src="http://www.google.com/afsonline/show_afs_search.js"></script>

Anotaciones en CSE vinculados

Para CSE vinculados para trabajar, deber� especificar anotaciones como las que se muestran en el ejemplo anterior. A continuaci�n le proponemos dos formas de resolver el problema:

Anotaciones externas: puedes especificar la ubicaci�n de tu anotaci�n mediante etiquetas <Include>. Consulta m�s informaci�n sobre los archivos de anotaciones externas. En el ejemplo de la secci�n anterior, se han utilizado dos archivos de anotaciones externas: uno de ellos es un archivo almacenado en un servidor y el otro es el resultado de una secuencia de comandos.

Anotaciones integradas: puedes incluir las anotaciones en el mismo archivo utilizado para la especificaci�n del motor de b�squeda personalizado. Consulta m�s informaci�n sobre las anotaciones integradas. En el ejemplo anterior se observan dos anotaciones integradas: http://www.solarenergy.org/* y http://www.solarfacts.net/*.

Requerimos que cada archivo tenga un tama�o inferior a 3 MB. Si tiene m�s anotaciones, las puede dividir en varios archivos y utilizar etiquetas <Incluir> para especificar los archivos. Puede tener un m�ximo de cincuenta archivos, pero el tama�o total de todos los archivos incluidos debe ser inferior a 10 MB. Esperamos que le permita incluir un tama�o de anotaciones de 25K por CSE. Si necesita m�s, le animamos a ir a meta. Cree varios CSE, obtenga los resultados y j�ntelos para los usuarios. �Esta interfaz de programaci�n le permite hacerlo casi todo!