Verkn�pfte benutzerdefinierte Suchmaschinen

Bei einer verkn�pften CSE (Custom Search Engine, benutzerdefinierte Suchmaschine) wird die Spezifikation der Suchmaschine auf Ihrer Website gehostet. Bei einer unter Google gespeicherten CSE wird die Spezifikation bei Google gespeichert.

Bei einer traditionellen, unter Google gespeicherten CSE erstellen Sie die CSE entweder, indem Sie sich anmelden und den Assistenten verwenden, oder indem Sie eine XML-Datei erstellen und �ber die Registerkarte "Erweitert" auf Google hochladen. Der verwendete Suchfeldcode verweist auf diese mit dem Parameter "cx" unter Google gespeicherte Spezifikation. Wenn Sie die CSE in irgendeiner Weise �ndern m�chten, verwenden Sie entweder das Steuerungsfeld oder laden Sie die neue XML-Spezifikation hoch. Hierbei gelten jedoch einige Einschr�nkungen:

Die Erstellung und Wartung einer CSE erfolgt manuell.
Es ist schwierig eine gro�e Anzahl an CSEs zu erstellen, z. B. je eine f�r jeden Ihrer Nutzer oder jeweils eine geringf�gig unterschiedliche f�r jede Ihrer Seiten.
Es ist schwierig mit anderen Datenquellen abgesehen von z. B. iCal, RSS, Google Base programmatisch CSEs zu erstellen.

F�r verkn�pfte CSEs gelten diese Beschr�nkungen f�r unter Google gespeicherte CSEs nicht. Mit verkn�pften CSEs wird die CSE-Spezifikation auf Ihrer Website gehostet und die URL f�r diese Spezifikation in Ihre CSE-Suchanfrage aufgenommen. Google ruft die CSE-Spezifikation von Ihrer Website ab, wenn Ihr Nutzer in der CSE sucht. Dies hat einige wichtige Vorteile:

Sie k�nnen problemlos Daten f�r eine benutzerdefinierte Suchmaschine konvertieren.
Sie k�nnen automatisch eine beliebige Anzahl an CSEs erstellen, jede auf einen bestimmten Nutzer, eine bestimmte Seite, eine bestimmte Tageszeit abgestimmt. Sie k�nnen CSEs nach Bedarf erstellen, um auf Nutzeranfragen oder Seiten auf Ihrer Website zu reagieren, von der aus der Nutzer sucht. Wir stellen verschiedene interessante Tools bereit, z. B. zur Erstellung einer verkn�ften CSE mithilfe der Links auf einer Seite, die Sie verwenden k�nnen.
Sie k�nnen problemlos die Definitionen Ihrer verkn�pften CSE �ndern, ohne Daten an Google verschieben zu m�ssen.
Es gibt keine globalen Einschr�nkungen f�r die Anzahl der Annotationen pro Nutzer.

Sie k�nnen Ihre Ideen aussch�pfen, wenn Sie dynamisch CSEs erstellen. Unsere Tools und Tools von Drittanbietern erleichtern die Synchronisierung Ihrer CSE mit Ihrer Website und Sites von anderen. Einige interessante Datenquellen zur Erstellung von CSEs sind iCal-Feeds, Ihre Referrer-Protokolle und die Lesezeichen oder der Browserverlauf Ihrer Nutzer. Dar�ber hinaus k�nnen Sie auch das Aussehen und Verhalten Ihrer CSE im Hinblick auf den Zustand und das Besuchsaufkommen Ihrer Website ver�ndern. Seien Sie kreativ! Die M�glichkeiten sind unbegrenzt.

CSE-Spezifikation kann auf mehr als eine externe Annotationsdatei verweisen. Dadurch wird die gemeinsame Nutzung von Annotationen f�r mehrere CSEs vereinfacht.

Einige Funktionen der unter Google gespeicherten CSEs wie die Zusammenarbeit und Google Marker funktionieren nicht mit verkn�pften CSEs. Wenn Sie bereits Annotationen bei Google gespeichert haben, k�nnen Sie diese herunterladen und in Ihre verkn�pfte CSE einf�gen. Lesen Sie f�r weitere Informationen den Artikel �bergang von einer unter Google gespeicherten CSE zu einer verkn�pften CSE. Verkn�pfte CSEs sind stets kostenlose, von Anzeigen unterst�tzte CSEs. Der Mechanismus f�r verkn�pfte CSEs kann nicht zum Hosten von CSE-Spezifikationen f�r Google�Site Search verwendet werden.

Beispiel einer vekn�pften CSE

Im Folgenden finden Sie ein sehr einfaches Beispiel f�r die Verwendung einer verlinkten CSE, deren Spezifikation sich unter http://www.guha.com/cref_cse.xml befindet. Die CSE-Spezifikation enth�lt die zu durchsuchenden Websites, die Darstellungsweise der Ergebnisse usw. Hier ist der Code f�r das Suchfeld, das diese CSE-Spezifikation verwendet. Beachten Sie den mit "cref" bezeichneten Parameter.

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

Wichtige Formparameter:

cref: Die URL Ihrer CSE-Spezifikation
q: Das Suchfeld

Probieren Sie hier diese Suchmaschine aus.

Beachten Sie, dass sich dieses Suchfeld ebensogut auf derselben Website wie die CSE-Spezifikationsdatei befinden k�nnte, wie auf mehreren Seiten auf dieser Site oder sogar auf einer anderen Site.

Bei der ersten Suchanfrage eines Nutzers rufen wir zur Verarbeitung der Anfrage die CSE-Spezifikation ab. Au�erdem legen wir Ihre CSE-Spezifikation im Cache ab und aktualisieren sie regelm��ig. Sie m�ssen dann nicht jedes Mal auf die Anfrage von Google zur CSE-Spezifikation reagieren, wenn Ihr Nutzer eine Suchanfrage stellt. Wenn Sie die Spezifikation Ihrer verlinkten CSE �ndern und sie sofort aktualisieren m�ssen, geben Sie einfach die URL Ihrer CSE-Spezifikation auf unserer Seite zum Aktualisieren Ihrer verlinkten CSE ein.

Beispiel einer verkn�pften CSE mit auf Ihrer Website gehosteten Ergebnissen

Sie k�nnen eine verkn�pfte CSE genau wie eine standardm��ige Suchmaschine zum Hosten von Ergebnissen auf Ihrer Website verwenden. Verwenden Sie dazu zwei Code-Snippets - eines f�r das Suchfeld und das andere f�r die Suchergebnisse. Der Code f�r das Suchfeld �hnelt dem im oben stehenden Beispiel, bis auf einige Abweichungen:

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

Wichtige Formparameter:

action-Feld: Die URL, unter der Sie Ihre Ergebnisse hosten wollen (in diesem Beispiel: http://www.guha.com/results.html)
cref: Die URL Ihrer CSE-Spezifikation
cof: Entweder FORID:9, FORID:10 oder FORID:11. Dieser Parameter legt fest, welches Anzeigenformat Sie anzeigen m�chten. Weitere Informationen finden Sie in der CSE-Spezifikation.
q: Das Suchfeld

Platzieren Sie diesen Code bei der auf das oben stehende Feld action verweisenden URL an der Stelle, an der die Suchergebnise angezeigt werden sollen:

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

Annotationen in verlinkten CSEs

Damit eine verkn�pfte CSE funktioniert, m�ssen die Annotationen wie in dem oben stehenden Beispiel angegeben sein. Es gibt zwei Methoden zum Angeben von Annotationen:

Externe Annotationen: Den Speicherort Ihrer Annotationsdateien geben Sie durch <Include>-Tags an. Im Beispiel des vorherigen Abschnitts wurden zwei Dateien f�r externe Annotationen verwendet: eine Datei, die auf einem Server gespeichert ist, und eine andere, die die Ausgabe eines Skripts darstellt. Weitere Informationen zu Dateien f�r externe Annotationen

Inline-Annotationen: Sie f�gen die Annotationen zusammen mit Ihrer CSE-Spezifikation in dieselbe Datei ein. Das Beispiel oben enth�lt zwei Inline-Annotationen: http://www.solarenergy.org/* und http://www.solarfacts.net/*. Weitere Informationen zu Inline-Annotationen

Jede Datei darf maximal 3 MB gro� sein. Ist Ihre Annotationsdatei gr��er, k�nnen Sie die Annotationen in mehrere Dateien aufteilen und <Einschlie�en>-Tags zur Spezifizierung dieser Dateien verwenden. Es d�rfen bis zu 50 Dateien sein. Allerdings muss die Gr��e aller Dateien insgesamt unter 10 MB liegen. Damit k�nnen Sie sch�tzungsweise 25.000 Annotationen pro CSE einschlie�en. Falls Sie mehr ben�tigen, empfehlen wir, auf Metafunktion umzustellen - erstellen Sie mehrere CSEs, beziehen Sie die Ergebnisse und sammeln Sie sie f�r Ihre Nutzer. Diese programmgesteuerte Oberfl�che bietet Ihnen nahezu unbegrenzte M�glichkeiten.