Gelinkte aangepaste zoekmachines

In een Gelinkte CSE staan de specificaties van de zoekmachine op uw website. In een Door Google opgeslagen CSE staan de specificaties bij Google.

Met een traditionele aangepaste zoekmachine die door Google wordt opgeslagen, kunt u op twee manieren een aangepaste zoekmachine maken. U kunt zich aanmelden en de wizard gebruiken of een XML-bestand schrijven en dit uploaden naar Google (via het tabblad 'Geavanceerd'). De code voor het zoekvak dat u gebruikt, verwijst naar deze specificatie die door Google is opgeslagen met de parameter 'cx'. Als u een onderdeel van de aangepaste zoekmachine wilt wijzigen, gebruikt u het configuratiescherm of uploadt u de nieuwe XML-specificatie. Dit levert diverse beperkingen op:

Het maken en onderhouden van een CSE gaat handmatig.
Het is moeilijk om een zeer groot aantal CSE's te maken, bijvoorbeeld ��n voor elk van uw gebruikers of telkens een iets andere voor elk van uw pagina's.
Het is lastig met behulp van andere databronnen, zoals iCal, RSS, en Google Base, CSE's programmatisch te maken.

Gekoppelde aangepaste zoekmachines verhelpen de beperkingen van de door Google opgeslagen aangepaste zoekmachines. Bij gekoppelde aangepaste zoekmachines wordt de specificatie van de aangepaste zoekmachine op uw website gehost en wordt de URL voor deze specificatie opgenomen in de zoekopdracht voor uw aangepaste zoekmachine. Als een gebruiker een zoekopdracht uitvoert met uw aangepaste zoekmachine, haalt Google de specificatie van uw aangepaste zoekmachine van uw website. Dit heeft een aantal belangrijke voordelen:

U kunt uw gegevens eenvoudig omzetten in een aangepaste zoekmachine.
U kunt automatisch zo veel CSE's genereren als u maar wilt, en u kunt elk van deze zoekmachines afstemmen op bepaalde gebruikers, bepaalde pagina's, bepaalde momenten van de dag en noem maar op. Sterker nog, u kunt CSE's op verzoek maken, in antwoord op een zoekopdracht of een pagina op uw site waarvandaan uw gebruiker een zoekopdracht uitvoert. We hebben hiervoor allerlei handige hulpmiddelen ontwikkeld, zoals een gelinkte CSE die u kunt maken via de links op een pagina.
U kunt de definities van uw gelinkte CSE's eenvoudig bijwerken zonder gegevens door te geven aan Google.
Er zijn geen vaste limieten voor het aantal annotaties per gebruiker.

Nu kunt u al uw idee�n inzetten om dynamisch aangepaste zoekmachines te maken. Met de hulpmiddelen die wij en anderen bieden, kunt u uw aangepaste zoekmachines gemakkelijker in lijn houden met uw website en die van anderen. U kunt voor het maken van uw aangepaste zoekmachines bijvoorbeeld gebruikmaken van iCal feeds, uw logboeken op verwijzende sites en de bladwijzers of browsegeschiedenis van uw gebruikers. U kunt zelfs het uiterlijk van uw aangepaste zoekmachine aanpassen naar aanleiding van de gezondheid van uw website of het verkeer dat uw site trekt. Er zijn tal van mogelijkheden. Leef u uit!

CSE-specificatie kan verwijzen naar ��n of meer externe annotatiebestanden. Dit maakt het gemakkelijker om annotaties te delen tussen CSE's.

Sommige functies van aangepaste zoekmachines die door Google worden opgeslagen (zoals samenwerken en de Google-markering), werken niet voor gekoppelde aangepaste zoekmachines. Als u al annotatiebestanden heeft opgeslagen op de Google-server, kunt u deze downloaden en de annotaties opnemen in uw gekoppelde aangepaste zoekmachine. Voor meer informatie leest u 'Overstappen van een door Google opgeslagen aangepaste zoekmachine naar een gekoppelde aangepaste zoekmachine'. Denk eraan dat gekoppelde aangepaste zoekmachines altijd gratis, door advertenties ondersteunde aangepaste zoekmachines zijn. Denk er tevens aan dat gekoppelde aangepaste zoekmachines niet kunnen worden gebruikt voor het hosten van specificaties van aangepaste zoekmachines die voor Google Site Search zijn bedoeld.

Voorbeeld van een gelinkte CSE

Hieronder ziet u een heel eenvoudig voorbeeld van het gebruik van een gekoppelde aangepaste zoekmachine waarvan de specificatie zich op http://www.guha.com/cref_cse.xml bevindt. De specificatie van de aangepaste zoekmachine bevat onder meer de sites die worden doorzocht en de opmaak van de zoekresultaten. Hier vindt u de code voor het zoekvak dat deze specificatie gebruikt. Let vooral op de parameter '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.nl/cse/brand?form=cref"></script>
<!-- Google CSE Search Box Ends -->

Belangrijke formulierparameters:

cref: de URL van uw CSE-specificatie
q: Het zoekvak

Probeer deze zoekmachine hier uit.

Dit zoekvak kan zich op dezelfde pagina bevinden als het specificatiebestand van de aangepaste zoekmachine, op meerdere pagina's of zelfs op een andere site.

De eerste keer dat een gebruiker een zoekopdracht uitvoert, halen we de specificatie van uw aangepaste zoekmachine op en gebruiken we deze om de zoekopdracht te verwerken. We slaan de specificatie van uw aangepaste zoekmachine ook op en vernieuwen deze regelmatig. Zo hoeft u niet telkens wanneer uw gebruiker een zoekopdracht uitvoert, de specificaties van uw aangepaste zoekmachine aan Google door te geven. Als u de specificatie van uw gekoppelde aangepaste zoekmachine wijzigt en deze meteen wilt laten vernieuwen, gaat u naar onze vernieuwingspagina voor gekoppelde aangepaste zoekmachines en geeft u de URL op van de specificatie van uw aangepaste zoekmachine.

Voorbeeld van een gelinkte CSE waarvan de resultaten op uw site worden gehost

Net als met een standaard aangepaste zoekmachine kunt u met een gelinkte aangepaste zoekmachine resultaten op uw site hosten. Hiervoor heeft u twee codes nodig, ��n voor het zoekvak en ��n voor de zoekresultaten. De zoekvakcode lijkt op het bovenstaande voorbeeld, maar er zijn enkele verschillen:

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

Belangrijke formulierparameters:

actieveld: de URL waarop u de resultaten wilt hosten (in dit voorbeeld gebruiken we http://www.guha.com/results.html)
cref: de URL van uw CSE-specificatie
cof: FORID:9, FORID:10 of FORID:11. Hiermee wordt aangegeven welke advertentie-indelingen u wilt weergeven. Raadpleeg de specificatie van de aangepaste zoekmachine voor meer informatie.
q: Het zoekvak

Op de URL waarnaar in het bovenstaande veld actie wordt verwezen, moet u deze code plaatsen op de plek waar de zoekresultaten worden weergegeven:

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

Annotaties in gelinkte CSE's

Uw gelinkte CSE's werken alleen als u de annotaties opgeeft zoals in het bovenstaande voorbeeld. Er zijn twee manieren om annotaties op te geven:

Externe annotaties: u geeft de locatie van uw annotatiebestanden op met de tag '<Include>'. Meer informatie over externe annotatiebestanden. In het voorbeeld in het vorige gedeelte worden twee annotatiebestanden gebruikt: het ene bestand is opgeslagen op een server, het andere bestand is de uitvoer van een script.

Ge�ntegreerde annotaties: u plaatst de annotaties in hetzelfde bestand als de specificatie voor uw aangepaste zoekmachine. Lees meer over ge�ntegreerde annotaties. Het bovenstaande voorbeeld bevat twee ge�ntegreerde annotaties: http://www.solarenergy.org/* en http://www.solarfacts.net/*.

Elk bestand moet kleiner zijn dan 3 MB. Als u meer annotaties heeft, kunt u deze opsplitsen in meerdere bestanden en de tags <Include> gebruiken om deze bestanden op te geven. U kunt maximaal vijftig bestanden gebruiken, maar de totale grootte van alle bestanden moet minder dan 10 MB bedragen. Dit betekent dat u ongeveer 25.000 annotaties per CSE kunt opnemen. Als u er meer nodig heeft, raden we u aan meerdere CSE's te maken en de resultaten hiervan samen te voegen voor uw gebruikers. Met deze programmatische interface is vrijwel alles mogelijk.