Motores de pesquisa personalizados ligados

Num CSE ligado, a especifica��o do motor de pesquisa � alojada no seu Web site. Num CSE armazenado no Google, a especifica��o � armazenada no Google.

Com um CSE armazenado no Google tradicional, pode criar o CSE iniciando sess�o e utilizando o assistente ou escrevendo um ficheiro XML e carregando-o para o Google (atrav�s do separador Avan�adas). O c�digo de caixa de pesquisa que utiliza remete para esta especifica��o armazenada no Google utilizando o par�metro "cx". Para alterar qualquer aspecto do CSE, deve utilizar o Painel de controlo ou carregar a nova especifica��o XML. Isto imp�e diversas limita��es:

A cria��o e manuten��o de um CSE � um processo manual.
� dif�cil criar um grande n�mero de CSEs, por exemplo um para cada utilizador ou um ligeiramente diferente para cada uma das suas p�ginas.
� dif�cil utilizar outras origens de dados, como, por exemplo, o iCal, RSS, Google Base, etc. para criar CSEs de forma program�tica.

Os CSEs hiperligados ultrapassam estas limita��es dos CSEs armazenados no Google. Com CSEs hiperligados, aloja a especifica��o CSE no seu Web site e inclui o URL para esta especifica��o no seu pedido de pesquisa CSE. O Google obt�m a especifica��o CSE a partir do seu Web site quando o utilizador pesquisa no CSE. Isto traz v�rias vantagens bastante importantes:

Pode converter facilmente os dados num Motor de pesquisa personalizado.
Pode gerar automaticamente qualquer n�mero de CSEs, cada um dele optimizado para um utilizador espec�fico, uma p�gina, a hora do dia, etc. Na realidade, pode gerar CSEs a pedido, em resposta a uma consulta dos utilizadores ou a uma p�gina existente no seu site e que est� a ser pesquisada por um utilizador. Fornecemos v�rias ferramentas interessantes que poder� utilizar, tais como a cria��o de um CSE ligado a partir das links existentes numa p�gina.
Pode actualizar com facilidade as defini��es de CSE ligado sem enviar dados para o Google.
N�o existem limites de anota��es globais por utilizador.

Agora pode explorar todo o potencial das suas ideias para gerar CSEs dinamicamente. As ferramentas fornecidas por n�s e por terceiros facilitam a manuten��o do seu CSE em sincronia com o seu pr�prio Web site e com outros sites. Algumas origens de dados interessantes que poder� utilizar para criar CSEs s�o feeds iCal, os registos das refer�ncias e os marcadores ou hist�ricos de navega��o dos seus utilizadores. Poder� mesmo alterar o aspecto e a funcionalidade do seu CSE em resposta � condi��o de funcionamento ou tr�fego do seu Web site. Seja criativo - as possibilidades s�o ilimitadas!

A especifica��o CSE pode fazer refer�ncia a um ou mais ficheiros de anota��es externas. Deste modo, � mais f�cil partilhar anota��es entre CSEs.

No entanto, tenha em aten��o que algumas funcionalidades dos CSEs armazenados no Google, tais como colabora��o e o Marcador Google, n�o funcionam com CSEs hiperligados. Se j� possui anota��es armazenadas no Google, pode transferi-las e inclu�-las no seu CSE hiperligado. Para obter mais informa��es, consulte Mudar de um CSE armazenado no Google para um CSE hiperligado. Tenha igualmente em aten��o que os CSEs hiperligados s�o sempre CSEs suportados por publicidade e gratuitos; o mecanismo do CSE hiperligado n�o pode ser utilizado para alojar especifica��es CSE para o Google Site Search.

Exemplo de um CSE ligado

Segue-se um exemplo muito simples da utiliza��o de um CSE hiperligado, cuja especifica��o se encontra em http://www.guha.com/cref_cse.xml. A especifica��o do CSE cont�m os sites para pesquisa, o aspecto e a funcionalidade dos resultados, etc. Encontrar� aqui o c�digo para a caixa de pesquisa que utiliza esta especifica��o de CSE. Atente no par�metro denominado "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="http://www.google.pt/cse/brand?form=cref"></script>
<!-- Google CSE Search Box Ends -->

Par�metros de formul�rio importantes:

cref: O URL da especifica��o do seu CSE
q: A caixa de consulta

Experimente este motor de pesquisa aqui!

Note que esta caixa de pesquisa podia estar no mesmo site do ficheiro de especifica��o do CSE, em v�rias p�ginas nesse site ou at� num site diferente.

Na primeira vez que um utilizador envia uma pesquisa de consulta, , obtemos a especifica��o CSE e utilizamo-la para processar a consulta. Tamb�m colocamos em cache a sua especifica��o CSE e actualizamo-la periodicamente para n�o ter que se preocupar com o servi�o dos pedidos de especifica��o CSE do Google sempre que o seu utilizador envia uma consulta. Se alterar a especifica��o do seu CSE hiperligado e necessitar que esta seja actualizada de imediato aceda � nossa p�gina de actualiza��o do CSE hiperligado e introduza o URL da sua especifica��o CSE.

Exemplo de um CSE ligado com resultados alojados no seu site

Tal como acontece com um Motor de pesquisa personalizado, tamb�m poder� utilizar um CSE ligado para alojar os resultados no seu site. Para que isso seja poss�vel, precisa de dois fragmentos de c�digo, um para a caixa de pesquisa e outro para os resultados de pesquisa. O c�digo da caixa de pesquisa tem um aspecto semelhante ao exemplo acima, com algumas altera��es:

<!-- 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="http://www.google.pt/cse/brand?form=cref_iframe"></script>
<!-- Google CSE Search Box Ends -->

Par�metros de formul�rio importantes:

campo de ac��o: O URL no qual pretende alojar os resultados (neste exemplo, utilizamos http://www.guha.com/results.html)
cref: O URL da especifica��o do seu CSE
cof: FORID:9, FORID:10 ou FORID:11. Especifica o formato de an�ncio que pretende visualizar. Consulte a especifica��o CSE para obter mais informa��es.
q: A caixa de consulta

No URL indicado pelo campo ac��o acima, ter� de colocar este c�digo no local onde pretende que os resultados da pesquisa sejam apresentados:

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

Anota��es em CSEs ligados

Para os CSEs ligados funcionarem, ter� de especificar as anota��es, tal como mostrado no exemplo anterior. Existem duas formas de especificar anota��es:

Anota��es externas: para especificar a localiza��o dos ficheiros de anota��o, utilize tags <Include>. Leia mais sobre ficheiros de anota��o externos. O exemplo que vimos na sec��o anterior utiliza dois ficheiros de anota��o externos, um dos quais � um ficheiro armazenado num servidor e o outro corresponde ao resultado de um script.

Anota��es in-line: As anota��es e a especifica��o do CSE s�o colocadas no mesmo ficheiro. Leia mais sobre anota��es in-line. O exemplo anterior cont�m duas anota��es in-line: http://www.solarenergy.org/* e http://www.solarfacts.net/*.

� necess�rio que cada ficheiro tenha menos de 3 MB. Se tiver mais anota��es do que isso, poder� dividi-las em v�rios ficheiros e utilizar tags <Include> para especificar esses ficheiros. S�o permitidos at� cinquenta ficheiros, mas o tamanho total de todos os ficheiros inclu�dos deve ser inferior a 10 MB. Deste modo, esperamos que seja poss�vel incluir aproximadamente 25.000 anota��es por CSE. Se precisar de mais anota��es, utilize metadados: crie v�rios CSEs, obtenha os resultados e organize-os para os utilizadores. Esta interface de programa��o permite fazer quase tudo!