Odkazovan� Vlastn� vyhled�va�e

V p��pad� Odkazovan�ho CSE je specifikace vyhled�va�e hostovan� na va�ich webov�ch str�nk�ch. V p��pad� CSE ulo�en�ho na Google je specifikace ulo�ena na Google.

Chcete-li vytvo�it tradi�n� CSE ulo�en� na Googlu, p�ihlaste se a pou�ijte pr�vodce nebo vytvo�te soubor XML a prost�ednictv�m karty Pokro�il� jej nahrajte na Google. Pou�it� k�d vyhled�vac�ho pole bude na tuto specifikaci ulo�enou na Googlu odkazovat pomoc� parametru cx. Ke zm�n� libovoln�ho aspektu CSE je t�eba pou��t Ovl�dac� panel nebo nahr�t novou specifikaci XML. Z toho plyne n�kolik omezen�:

Vytvo�en� a spr�va CSE je ru�n� proces.
Je obt��n� vytvo�it velk� po�et CSE, �ekn�me jeden pro ka�d�ho z va�ich u�ivatel�, nebo nepatrn� odli�n� pro ka�dou z va�ich str�nek.
Pou��vat jin� zdroje dat, nap�. iCal, RSS, Google Base apod. k programov�mu vytv��en� CSE je obt��n�.

Odkazovan� vyhled�va�e CSE nejsou v�z�ny t�mito omezen�mi vyhled�va�� CSE ulo�en�ch na serveru Google. P�i pou�it� odkazovan�ch CSE hostujete specifikaci CSE na sv�m webu a vlo��te adresu URL t�to specifikace do sv�ho po�adavku vyhled�v�n� pro vyhled�va� CSE. Server Google na�te p�i vyhled�v�n� pomoc� va�eho CSE specifikaci CSE z va�eho webu. To p�in�� n�kolik velmi d�le�it�ch v�hod:

Sv� data m��ete do Vlastn�ho vyhled�va�e jednodu�e p�ev�st.
M��ete automaticky vygenerovat libovoln� po�et CSE, ka�d� z nich m��e b�t u�it na m�ru konkr�tn�mu u�ivateli, str�nce, denn� dob� apod. Ve skute�nosti m��ete generovat CSE na p��n�, jako odezvu na u�ivatelsk� dotazy nebo str�nku webu, odkud u�ivatel vyhled�v�. K pou�it� v�m nab�z�me n�kolik zaj�mav�ch n�stroj�, nap�. vytv��en� odkazovan�ho CSE z odkaz� na str�nce.
Definice sv�ho odkazovan�ho CSE m��ete snadno aktualizovat, ani� byste museli nahr�vat data na servery Google.
Na po�et anotac� jednotliv�ch u�ivatel� se nevztahuj� ��dn� celkov� limity.

Nyn� m��ete naplno vyu��t s�ly sv�ch my�lenek a generovat CSE dynamicky. N�stroje, kter� v�m poskytujeme my a t�et� strany, usnad�uj� synchronizaci va�eho CSE s webov�mi str�nkami a vyhled�va�i ostatn�ch u�ivatel�. Mezi zaj�mav� zdroje dat, kter� m��ete pou��vat k vytv��en� CSE, pat�� kan�ly iCal, z�znamy o doporu�en�ch, z�lo�ky a historie surfov�n� u�ivatel�. M��ete dokonce m�nit vzhled a styl sv�ho CSE v reakci na stav a provoz va�ich webov�ch str�nek. Bu�te kreativn� - mo�nosti jsou neomezen�!

Specifikace CSE m��e odkazovat na jeden �i v�ce extern�ch soubor� anotac�. To umo��uje jednodu�e sd�let anotace mezi r�zn�mi CSE.

N�kter� funkce vyhled�va�� CSE ulo�en�ch na Googlu, nap��klad spolupr�ce nebo slu�ba Google Marker, s odkazovan�mi CSE nefunguj�. Pokud ji� m�te na serveru Google ulo�en� anotace, m��ete je st�hnout a zahrnout do sv�ho odkazovan�ho CSE. Dal�� informace naleznete v t�matu P�echod z CSE ulo�en�ho na Googlu na odkazovan� CSE. Odkazovan� vyhled�va�e CSE jsou v�dy zdarma; jsou podporov�ny reklamou. Mechanismus odkazovan�ho CSE nelze pou��t k hostov�n� specifikac� CSE pro Prohled�v�n� web� Google.

P��klad odkazovan�ho CSE

Zde uv�d�me velmi jednoduch� p��klad pou�it� odkazovan�ho vyhled�va�e CSE, jeho� specifikace je ulo�ena na adrese http://www.guha.com/cref_cse.xml. Tato specifikace CSE obsahuje weby, kter� budou prohled�v�ny, vzhled a dojem v�sledk� apod. Zde je k�d pro vyhled�vac� pole, kter� tuto specifikaci CSE vyu��v�. V�imn�te si parametru s n�zvem 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 -->

D�le�it� parametry formul��e:

cref: Adresa URL va�� specifikace CSE
q: Pole s dotazem

Tento vyhled�va� si vyzkou�ejte zde!

Toto vyhled�vac� pole m��e b�t na stejn�m webu jako soubor se specifikac� CSE, na v�ce str�nk�ch tohoto webu nebo dokonce na jin�m webu.

P�i prvn�m odesl�n� vyhled�vac�ho dotazu na�teme specifikaci CSE a pou�ijeme ji ke zpracov�n� dotazu. Tak� ji ulo��me do mezipam�ti a budeme ji pravideln� aktualizovat. Nemus�te tedy m�t obavy, �e p�i ka�d�m jednom odesl�n� vyhled�vac�ho dotazu by si Google znovu vy��dal specifikaci CSE. Pokud zm�n�te specifikaci odkazovan�ho CSE a chcete ji aktualizovat okam�it�, jednodu�e p�ejd�te na str�nku aktualizace odkazovan�ch CSE a zadejte adresu URL sv� specifikace CSE.

P��klad odkazovan�ho CSE s v�sledky hostovan�mi na va�em webu

Stejn� jako standardn� Vlastn� vyhled�va�, tak� odkazovan� CSE m��ete pou��vat k hostov�n� v�sledk� na sv�m webu. K tomu pot�ebujete dva �seky k�du: jeden pro vyhled�vac� pole a druh� pro v�sledky hled�n�. S v�jimkou n�kolika zm�n vypad� vyhled�vac� pole jako ve v��e uveden�m p��kladu:

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

D�le�it� parametry formul��e:

Pole action: Adresa URL, kde chcete hostit v�sledky (v tomto p��kladu pou��v�me http://www.guha.com/results.html)
cref: Adresa URL va�� specifikace CSE
cof: Hodnota FORID:9, FORID:10 nebo FORID:11. Tato mo�nost ur�uje, jak� form�t reklam chcete zobrazovat. Dal�� informace naleznete ve specifikaci CSE.
q: Pole s dotazem

Na adrese URL, na n�� odkazuje v��e uveden� pole akce, mus�te um�stit tento k�d tam, kde se maj� zobrazovat v�sledky hled�n�:

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

Anotace v odkazovan�ch CSE

Aby odkazovan� CSE fungovaly, mus�te zadat anotace podle zn�zorn�n� ve v��e uveden�m p��kladu. Anotace m��ete zadat dv�ma zp�soby:

Extern� anotace: Um�st�n� sv�ch soubor� s anotacemi ur��te pomoc� zna�ek <Include>. Dal�� informace o souborech extern�ch anotac�. P��klad uveden� v p�edch�zej�c� ��sti pou��v� dva extern� soubory s anotacemi: jeden je soubor ulo�en� na serveru a druh� je v�stupem skriptu.

Vlo�en� anotace: Anotace jsou vlo�eny ve stejn�m souboru se specifikacemi CSE. Dal�� informace o vlo�en�ch anotac�ch. V��e uveden� p��klad m� dv� vlo�en� anotace: http://www.solarenergy.org/* a http://www.solarfacts.net/*.

Vy�adujeme, aby velikost v�ech soubor� byla men�� ne� 3 MB. Pokud va�e anotace toto omezen� p�ekra�uj�, m��ete je rozd�lit do v�ce soubor� a k ur�en� t�chto soubor� pou��t zna�ky <Include>. M��ete m�t a� pades�t soubor�, av�ak celkov� velikost v�ech zahrnut�ch soubor� mus� b�t men�� ne� 10 MB. P�edpokl�d�me, �e toto omezen� v�m umo�n� zahrnout do ka�d�ho CSE 25 tis�c anotac�. Budete-li pot�ebovat v�ce, doporu�ujeme v�m j�t o �rove� v��e - vytvo�it n�kolik CSE, z�skat z nich v�sledky a poskytovat je u�ivatel�m najednou. Toto programov� rozhran� v�m umo��uje d�lat prakticky cokoli!