Mecanismos de pesquisa personalizados vinculados

Em um Mecanismo de pesquisa personalizado vinculado, a especifica��o do mecanismo de pesquisa � hospedada no seu site. Em um Mecanismo de pesquisa personalizado armazenado no Google, a especifica��o � armazenada no Google.

Com um Mecanismo de pesquisa personalizado armazenado pelo Google tradicional, voc� cria o Mecanismo de pesquisa personalizado fazendo login e usando o assistente ou escrevendo um arquivo XML e enviando para o Google (usando a guia Configura��es avan�adas). O c�digo da caixa de pesquisa que voc� usa se refere a esta especifica��o armazenada no Google usando o par�metro "cx". Para alterar qualquer aspecto do Mecanismo de pesquisa personalizado, voc� precisa usar o Painel de controle ou enviar a nova especifica��o XML. Isso imp�es v�rias limita��es:

A cria��o e a manuten��o de um Mecanismo de pesquisa personalizado � um processo manual.
� dif�cil criar um n�mero muito grande de Mecanismos de pesquisa personalizados, digamos um para cada usu�rio ou um ligeiramente diferente para cada p�gina.
� dif�cil usar outras origens de dados como iCal, RSS, Google Base, etc. para criar Mecanismos de pesquisa personalizados de maneira programada.

Os Mecanismos de pesquisa personalizados vinculados superam essas limita��es dos Mecanismos de pesquisa personalizados armazenados pelo Google. Com os Mecanismos de pesquisa personalizados vinculados, voc� hospeda a especifica��o do Mecanismo de pesquisa personalizado no seu site e inclui o URL dessa especifica��o na solicita��o de pesquisa do Mecanismo de pesquisa personalizado. Quando o usu�rio faz uma pesquisa no Mecanismo de pesquisa personalizado, o Google recupera a especifica��o no seu site. Isso traz v�rios benef�cios muito importantes:

Voc� pode converter facilmente seus dados em um Mecanismo de pesquisa personalizado.
Voc� pode gerar automaticamente qualquer n�mero de Mecanismos de pesquisa personalizados, cada um voltado possivelmente para um usu�rio espec�fico, uma p�gina espec�fica, hora do dia, etc. Na realidade, � poss�vel gerar Mecanismos de pesquisa personalizados sob demanda, em resposta � consulta dos usu�rios ou � uma p�gina do seu site procurada pelo usu�rio. Fornecemos v�rias ferramentas interessantes que podem ser usadas, como a cria��o de um Mecanismo de pesquisa personalizado vinculado aos links de uma p�gina.
Voc� pode atualizar facilmente as defini��es do seu Mecanismo de pesquisa personalizado vinculado sem enviar dados ao Google.
N�o h� nenhum limite global de anota��o por usu�rio.

Agora voc� pode explorar todo o poder de suas ideias para gerar Mecanismos de pesquisa personalizados dinamicamente. As ferramentas fornecidas por n�s e por terceiros facilitam a sincroniza��o do seu Mecanismo de pesquisa personalizado com seu pr�prio site e os sites de outros. Os feeds iCal, logs de refer�ncia e marcadores ou hist�rico de navega��o dos usu�rios, s�o interessantes origens de dados que podem ser usados para criar Mecanismos de pesquisa personalizados. Voc� pode inclusive alterar a apar�ncia do seu mecanismo de pesquisa personalizado em resposta � integridade ou ao tr�fego do seu site. Seja criativo, as possibilidades s�o infinitas!

A especifica��o do Mecanismo de pesquisa personalizado pode fazer refer�ncia a um ou mais arquivos de anota��o externa. Isso facilita o compartilhamento de anota��es entre Mecanismos de pesquisa personalizados.

Entretanto, observe que alguns dos recursos dos Mecanismos de pesquisa personalizados armazenados pelo Google, como a colabora��o e o Google Marker, n�o funcionar�o com Mecanismos de pesquisa personalizados vinculados. Se voc� j� tiver anota��es armazenadas com o Google, poder� fazer o download delas e inclu�-las no seu Mecanismo de pesquisa personalizado vinculado. Para obter mais informa��es, leia Como alternar do Mecanismo de pesquisa personalizado armazenado pelo Google para o Mecanismo de pesquisa personalizado vinculado. Observe tamb�m que Mecanismos de pesquisa personalizados vinculados s�o sempre gratuitos e suportados pelos an�ncios; o mecanismo de Mecanismo de pesquisa personalizado vinculado n�o pode ser usado para hospedar especifica��es do Mecanismo de pesquisa personalizado para o Google Site Search.

Exemplo de um Mecanismo de pesquisa personalizado vinculado

Veja, a seguir, um exemplo muito simples do uso de um Mecanismo de pesquisa personalizado vinculado, cuja especifica��o pode ser encontrada em http://www.guha.com/cref_cse.xml. A especifica��o do Mecanismo de pesquisa personalizado cont�m os sites que devem ser pesquisados, a apar�ncia dos resultados etc. Este � o c�digo da caixa de pesquisa que usa essa especifica��o do Mecanismo de pesquisa personalizado. Observe o par�metro chamado "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 formul�rio importantes:

cref: o URL da especifica��o do seu Mecanismo de pesquisa personalizado
q: a caixa de consulta

Experimente este mecanismo de pesquisa aqui!

Observe que essa caixa de pesquisa poderia estar no mesmo site do arquivo de especifica��o do Mecanismo de pesquisa personalizado, em v�rias p�ginas desse site ou mesmo em um site diferente.

Na primeira vez em que um usu�rio fizer uma consulta de pesquisa, n�s buscaremos a especifica��o do Mecanismo de pesquisa personalizado e a usaremos para processar a consulta. Al�m disso, n�s tamb�m armazenamos a sua especifica��o do Mecanismo de pesquisa personalizado em cache e a atualizamos periodicamente, de modo que voc� n�o precisa se preocupar em fornecer as solicita��es de especifica��o do Mecanismo de pesquisa personalizado do Google toda vez que o seu usu�rio fizer uma consulta. Se voc� alterar a especifica��o do seu Mecanismo de pesquisa personalizado vinculado e precisar atualiz�-la imediatamente, basta ir at� a nossa p�gina de atualiza��o do Mecanismo de pesquisa personalizado vinculado e inserir o seu URL da sua especifica��o do Mecanismo de pesquisa personalizado.

Exemplo de um Mecanismo de pesquisa personalizado vinculado com resultados hospedados no seu site

Assim como em um Mecanismo de pesquisa personalizado padr�o, voc� tamb�m pode usar um Mecanismo de pesquisa personalizado vinculado para hospedar resultados no seu site. Para fazer isso, s�o necess�rios dois snippets do c�digo, um para a caixa de pesquisa e o outro para os resultados de pesquisa. O c�digo da caixa de pesquisa � similar ao exemplo acima, com algumas mudan�as:

<!-- 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 formul�rio importantes:

campo de a��o: O URL no qual deseja hospedar os resultados (nesse exemplo, usamos http://www.guha.com/results.html)
cref: o URL da especifica��o do seu Mecanismo de pesquisa personalizado
cof: FORID:9, FORID:10 ou FORID:11. Isso especifica qual formato de an�ncio voc� deseja exibir. Consulte a especifica��o do Mecanismo de pesquisa personalizado para obter mais informa��es.
q: a caixa de consulta

No URL apontado pelo campo de a��o acima, � necess�rio colocar esse c�digo onde deseja exibir os resultados de pesquisa:

<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 nos Mecanismos de pesquisa personalizados vinculados

Para que os Mecanismos de pesquisa personalizados vinculados funcionem, � necess�rio especificar as anota��es como mostra o exemplo acima. H� duas maneiras de especificar anota��es:

Anota��es externas: voc� especifica o local dos arquivos de anota��o usando as tags <Include>. Mais informa��es sobre arquivos de anota��o externa. O exemplo que vimos na se��o anterior usa dois arquivos de anota��o externa: um arquivo armazenado em um servidor e o outro � a sa�da de um script.

Anota��es inline: voc� coloca as anota��es junto com a especifica��o do seu Mecanismo de pesquisa personalizado no mesmo arquivo. Mais informa��es sobre anota��es inline. O exemplo acima tem duas anota��es inline: http://www.solarenergy.org/* e http://www.solarfacts.net/*.

Cada arquivos deve ter no m�ximo 3 MB. Se voc� tiver mais anota��es, divida-as em v�rios arquivos e use as tags <Include> para especificar esses arquivos. S�o permitidos at� 50 arquivos, mas o tamanho total de todos os arquivos inclu�dos deve ser menor do que 10 MB. Desse modo, esperamos que seja poss�vel incluir aproximadamente 25.000 anota��es por Mecanismo de pesquisa personalizado. Se precisar de mais anota��es, v� aos metadados: crie v�rios Mecanismos de pesquisa personalizados, obtenha os resultados e coloque-os juntos para os usu�rios. Essa interface de programa��o permite que voc� fa�a quase tudo!