Diese Seite bezieht sich auf die XML-Version der Custom Search JSON API, die nur für Kunden von Google Site Search verfügbar ist.
- Übersicht
- Anfrageformat der Programmable Search Engine
- XML-Ergebnisse
Überblick
Mit Google WebSearch können Kunden von Google Site Search Google-Suchergebnisse auf ihren eigenen Websites anzeigen. Der WebSearch-Dienst verwendet für die Bereitstellung von Suchergebnissen ein einfaches HTTP-basiertes Protokoll. Administratoren für die Suche haben die vollständige Kontrolle darüber, wie sie Suchergebnisse anfordern und wie sie sie dem Endnutzer präsentieren. In diesem Dokument werden die technischen Details der Google-Suchanfrage und der Ergebnisformate beschrieben.
Zum Abrufen von Google WebSearch-Ergebnissen sendet Ihre Anwendung eine einfache HTTP-Anfrage an Google. Google gibt Suchergebnisse dann im XML-Format zurück. Mit XML-formatierten Ergebnissen können Sie die Anzeige der Suchergebnisse anpassen.
WebSearch-Anfrageformat
- Anfrageübersicht
- Suchbegriffe
- Anfrageparameter
- Beispiele für WebSearch-Suchanfragen
- Definitionen von WebSearch-Suchparametern
- Beispiele für Bild-Suchanfragen
- Definitionen der Suchparameter für die Bildersuche
- Erweiterte Suche
- Erweiterte Suchparameter
- Spezielle Suchbegriffe
- Anfragelimits
Anfragen – Übersicht
Die Google-Suchanfrage ist ein Standard-HTTP-GET
-Befehl. Es enthält eine Sammlung von Parametern, die für Ihre Abfragen relevant sind. Diese Parameter sind in der Anfrage-URL als Name=Wert-Paare enthalten, getrennt durch kaufmännische Und-Zeichen (&). Parameter enthalten Daten wie die Suchanfrage und eine eindeutige Suchmaschinen-ID (cx
), die die Suchmaschine identifiziert, von der die HTTP-Anfrage ausgeht. Der Dienst WebSearch oder Bildersuche gibt als Antwort auf Ihre HTTP-Anfragen XML-Ergebnisse zurück.
Suchbegriffe
Die meisten Suchanfragen enthalten einen oder mehrere Suchbegriffe. Ein Suchbegriff wird als Wert eines Parameters in der Suchanfrage angezeigt.
Mit Suchbegriffen können verschiedene Arten von Informationen angegeben werden, um die von Google zurückgegebenen Suchergebnisse zu filtern und zu organisieren. In Abfragen kann Folgendes angegeben werden:
- Ein- oder auszuschließende Wörter oder Wortgruppen
- Alle Wörter in einer Suchanfrage (Standardeinstellung)
- Eine genaue Wortgruppe in der Suchanfrage
- Beliebige Wörter oder Wortgruppen in einer Suchanfrage
- Wo im Dokument nach den Suchbegriffen gesucht werden soll
- Beliebige Stelle im Dokument (Standardeinstellung)
- Nur im Textbereich des Dokuments
- Nur im Titel des Dokuments
- Nur in der Dokument-URL
- Nur in Links im Dokument
- Einschränkungen für die Dokumente selbst
- Ein- oder Ausschließen von Dokumenten bestimmter Dateitypen (z. B. PDF-Dateien oder Word-Dokumente)
- Spezielle URL-Suchanfragen, die Informationen zu einer bestimmten URL zurückgeben, anstatt eine Suche durchzuführen.
- Abfragen, bei denen allgemeine Informationen zu einer URL zurückgegeben werden, z. B. Open Directory-Kategorie, -Snippet oder -Sprache
- Suchanfragen, bei denen die Webseiten zurückgegeben werden, die auf eine URL verweisen
- Suchanfragen, die eine Reihe von Webseiten zurückgeben, die einer bestimmten URL ähnlich sind
Standardsuche
Die Werte der Suchparameter müssen URL-Escaping sein. Beachten Sie, dass Sie das Pluszeichen ("+") durch alle Leerzeichenfolgen in der Suchanfrage ersetzen würden. Dies wird im Abschnitt URL-Escaping dieses Dokuments näher erläutert.
Der Suchbegriff wird mit dem Parameter q an den WebSearch-Dienst gesendet. Hier ein Beispiel für einen Suchbegriff:
q=horses+cows+pigs
Standardmäßig gibt der Google WebSearch-Dienst nur Dokumente zurück, die alle Begriffe der Suchanfrage enthalten.
Anforderungsparameter
In diesem Abschnitt sind die Parameter aufgeführt, die Sie bei einer Suchanfrage verwenden können. Die Parameter werden in zwei Listen aufgeteilt. Die erste Liste enthält Parameter, die für alle Suchanfragen relevant sind. Die zweite Liste enthält Parameter, die nur für erweiterte Suchanfragen relevant sind.
Drei Anfrageparameter sind erforderlich:
- Der Parameter client muss auf
google-csbe
festgelegt sein - Der output-Parameter gibt das Format der zurückgegebenen XML-Ergebnisse an. Ergebnisse können mit (xml) oder ohne (
xml_no_dtd
) eines Verweises auf die DTD von Google zurückgegeben werden. Wir empfehlen, diesen Wert aufxml_no_dtd
festzulegen. Hinweis: Wenn Sie diesen Parameter nicht angeben, werden die Ergebnisse in HTML und nicht in XML zurückgegeben.
- Der Parameter cx, der die eindeutige ID der Suchmaschine darstellt.
Neben den oben genannten sind die am häufigsten verwendeten Anfrageparameter:
- num: die angeforderte Anzahl von Suchergebnissen
- q: Suchbegriff(e)
- start: der Startindex für die Ergebnisse
Beispiele für WebSearch-Suchanfragen
Die folgenden Beispiele zeigen einige WebSearch-HTTP-Anfragen, um die Verwendung verschiedener Abfrageparameter zu veranschaulichen. Definitionen für die verschiedenen Abfrageparameter finden Sie in diesem Dokument in den Abschnitten Definitionen von WebSearch-Suchparametern und Erweiterte Suchparameter.
Diese Anfrage fordert die ersten zehn Ergebnisse (start=0&num=10
) für den Suchbegriff „red sox“ (q=red+sox
) an. Außerdem gibt die Abfrage an, dass Ergebnisse von kanadischen Websites (cr=countryCA
) stammen und auf Französisch (lr=lang_fr
) verfasst werden sollen. Schließlich gibt die Abfrage Werte für die Parameter client, output und cx an, von denen alle drei erforderlich sind.
http://www.google.com/search?
start=0
&num=10
&q=red+sox
&cr=countryCA
&lr=lang_fr
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
In diesem Beispiel werden einige der Parameter für erweiterte Suchanfragen verwendet, um die Suchanfrage weiter anzupassen. In dieser Anfrage wird der Parameter as_q (as_q=red+sox
) anstelle des Parameters q verwendet. Außerdem wird der Parameter as_eq verwendet, um Dokumente, die das Wort "Yankees" enthalten, aus den Suchergebnissen (as_eq=yankees
) auszuschließen.
http://www.google.com/search?
start=0
&num=10
&as_q=red+sox
&as_eq=Yankees
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
Definitionen der WebSearch-Suchparameter
c2coff | |||||||
---|---|---|---|---|---|---|---|
Beschreibung | Optional: Mit dem Parameter c2coff wird die Funktion für die Suche in vereinfachtem und traditionellem Chinesisch aktiviert oder deaktiviert. Der Standardwert für diesen Parameter ist
|
||||||
Beispiele | q=google&c2coff=1 |
client | |
---|---|
Beschreibung | Erforderlich. Der Parameter |
Beispiele | q=google&client=google-csbe |
cr | |
---|---|
Beschreibung | Optional: Der Parameter Google WebSearch ermittelt das Land eines Dokuments durch die Analyse:
Im Abschnitt Werte für Länderparameter (cr) finden Sie eine Liste der gültigen Werte für diesen Parameter. |
Beispiele | q=Frodo&cr=countryNZ |
cx | |
---|---|
Beschreibung | Erforderlich. Der Parameter |
Beispiele | q=Frodo&cx=00255077836266642015:u-scht7a-8i |
Filter | |||||||
---|---|---|---|---|---|---|---|
Beschreibung | Optional: Der Parameter filter aktiviert oder deaktiviert die automatische Filterung von Google-Suchergebnissen. Weitere Informationen zu den Suchergebnisfiltern von Google finden Sie im Abschnitt Automatische Filterung in diesem Dokument. Der Standardwert für den Parameter
Hinweis:Standardmäßig wendet Google Filter auf alle Suchergebnisse an, um die Qualität dieser Ergebnisse zu verbessern. |
||||||
Beispiele | q=google&filter=0 |
gl | |
---|---|
Beschreibung | Optional: Der Parameterwert Durch Angabe eines |
Beispiele | Durch diese Anfrage werden im Vereinigten Königreich verfasste Dokumente in WebSearch-Ergebnissen verbessert: |
hl | |
---|---|
Beschreibung | Optional: Der Parameter Weitere Informationen finden Sie im Abschnitt Schnittstellensprachen der Präsentation zur Internationalisierung von Abfragen und Ergebnissen. Eine Liste der unterstützten Sprachen finden Sie unter Unterstützte Schnittstellensprachen. |
Beispiele | Diese Anfrage ist auf Anzeigen für Wein in französischer Sprache ausgerichtet. Vin ist der französische Begriff für Wein. q=vin&ip=10.10.10.10&ad=w5&hl=fr |
HQ | |
---|---|
Beschreibung | Optional: Mit dem Parameter |
Beispiele | Diese Anfrage sucht nach „Pizza“ UND „Käse“. Der Ausdruck ist mit
|
ie | |
---|---|
Beschreibung | Optional: Mit dem Parameter Im Abschnitt Zeichencodierung finden Sie Informationen zur Verwendung dieses Parameters. Die Liste der möglichen |
Beispiele | q=google&ie=utf8&oe=utf8 |
lr | |
---|---|
Beschreibung | Optional: Der Parameter Die Sprache eines Dokuments wird mit Google WebSearch anhand folgender Daten bestimmt:
Im Abschnitt Erfassungswerte für Sprache ( |
Beispiele | q=Frodo&lr=lang_en |
num | |
---|---|
Beschreibung | Optional: Der Parameter Der Standardwert für Hinweis: Wenn die Gesamtzahl der Suchergebnisse kleiner als die angeforderte Anzahl ist, werden alle verfügbaren Suchergebnisse zurückgegeben. |
Beispiele | q=google&num=10 |
oe | |
---|---|
Beschreibung | Optional: Der Parameter Im Abschnitt Zeichencodierung finden Sie Informationen zur Verwendung dieses Parameters. Die Liste der möglichen |
Beispiele | q=google&ie=utf8&oe=utf8 |
output | |||||||
---|---|---|---|---|---|---|---|
Beschreibung | Erforderlich. Der Parameter
|
||||||
Beispiele | output=xml_no_dtd |
q | |
---|---|
Beschreibung | Optional: Der Parameter Außerdem gibt es eine Reihe von speziellen Suchbegriffen, die als Teil des Werts des Parameters Das Steuerfeld für die Google Suche enthält einen Bericht zu den häufigsten Suchanfragen, die mit dem Parameter Hinweis:Der für den Parameter q angegebene Wert muss URL-Escaping sein. |
Beispiele | q=vacation&as_oq=london+paris |
sicher | |||||||||
---|---|---|---|---|---|---|---|---|---|
Beschreibung | Optional: Mit dem Parameter
Weitere Informationen zu dieser Funktion finden Sie im Abschnitt Inhalte nur für Erwachsene mit SafeSearch filtern. |
||||||||
Beispiele | q=adult&safe=high |
start | |
---|---|
Beschreibung | Optional: Der Parameter Der Parameter |
Beispiele | start=10 |
sort | |
---|---|
Beschreibung | Optional: Der Parameter |
Beispiele |
|
Ud | |
---|---|
Beschreibung | Optional: Der Parameter http://www.花井鮨.com Gültige Werte für diesen Parameter sind Wenn der Parameter http://www.xn--elq438j.com. Hinweis:Dies ist eine Betafunktion. |
Beispiele | q=google&ud=1 |
Erweiterte Suche
Die zusätzlichen Suchparameter, die unter dem Bild aufgeführt sind, sind für erweiterte Suchanfragen relevant. Wenn Sie eine erweiterte Suche senden, werden die Werte mehrerer Parameter (z.B. as_eq, as_epq, as_oq usw.) in die Suchbegriffe für diese Suche einbezogen. Das Bild zeigt die Seite „Erweiterte Suche“ von Google. Auf dem Bild steht der Name jedes Parameters für die erweiterte Suche in red Schrift in oder neben dem Feld auf der Seite, dem der Parameter entspricht.
Erweiterte Suchanfragenparameter
as_dt | |
---|---|
Beschreibung | Optional: Mit dem Parameter |
Beispiele | as_dt=i,as_dt=e |
as_epq | |
---|---|
Beschreibung | Optional: Der Parameter |
Beispiele | as_epq=abraham+lincoln |
as_eq | |
---|---|
Beschreibung | Optional: Der Parameter |
Beispiele |
|
as_lq | |
---|---|
Beschreibung | Optional: Der Parameter |
Beispiele |
|
as_nlo | |
---|---|
Beschreibung | Optional: Der Parameter |
Beispiele | Hier wird ein Suchbereich von 5 bis einschließlich 10 festgelegt:
|
as_nhi | |
---|---|
Beschreibung | Optional: Der Parameter |
Beispiele | Hier wird ein Suchbereich von 5 bis einschließlich 10 festgelegt:
|
as_oq | |
---|---|
Beschreibung | Optional: Der Parameter |
Beispiele |
|
as_q | |
---|---|
Beschreibung | Optional: Der Parameter |
Beispiele |
|
as_qdr | |
---|---|
Beschreibung | Optional: Mit dem Parameter
|
Beispiele |
In diesem Beispiel werden Ergebnisse aus dem letzten Jahr angefordert:
In diesem Beispiel werden Ergebnisse der letzten 10 Tage angefordert:
|
as_sitesearch | |
---|---|
Beschreibung | Optional: Mit dem Parameter |
Beispiele |
|
Spezielle Suchbegriffe
Mit Google WebSearch können verschiedene spezielle Suchbegriffe verwendet werden, mit denen auf zusätzliche Funktionen der Google-Suchmaschine zugegriffen werden kann. Diese speziellen Suchbegriffe sollten im Wert des Anfrageparameters q enthalten sein. Genau wie andere Suchbegriffe müssen auch die speziellen Suchbegriffe URL-Escaping verwendet werden. Eine Reihe der speziellen Suchbegriffe enthält einen Doppelpunkt (:). Dieses Zeichen muss auch URL-Escaping sein. Der Wert ist %3A
.
Backlinks [link:] | |
---|---|
Beschreibung | Der Abfragebegriff Die URL-Version von Sie können auch den Anfrageparameter as_lq verwenden, um eine Hinweis: Sie können keine anderen Suchbegriffe angeben, wenn Sie |
Beispiele |
|
Boolesch OR Suche [ OR ] | |
---|---|
Beschreibung | Mit dem Abfragebegriff Sie können auch den Anfrageparameter as_oq verwenden, um eine Suche nach einem beliebigen Begriff in einer Gruppe von Begriffen zu senden. Hinweis:Wenn in einer Suchanfrage die Abfrage "London+OR+Paris" angegeben ist, enthalten die Suchergebnisse Dokumente, die mindestens eines dieser beiden Wörter enthalten. In einigen Fällen können Dokumente in den Suchergebnissen beide Wörter enthalten. |
Beispiele | Nach London oder Paris suchen: Nutzereingabe:
london OR
paris Suchbegriff:q=london+OR+paris Nach Urlaub und entweder London oder Paris suchen: Suchbegriff:
q=vacation+london+OR+paris Suche nach Urlaub und nach London, Paris oder Pralinen: Suchbegriff:
q=vacation+london+OR+paris+OR+chocolates Suchen Sie nach Urlaub und Pralinen und entweder nach London oder Paris, wobei Pralinen das geringste Gewicht erhalten: Suchbegriff:
q=vacation+london+OR+paris+chocolates Suchen Sie in Dokumenten, die auch London oder Paris enthalten, nach Urlaub, Pralinen und Blumen: Suchbegriff:
q=vacation+london+OR+paris+chocolates+flowers Suchen Sie nach Urlaub und entweder London oder Paris oder nach Pralinen oder Blumen: Suchbegriff: q=vacation+london+OR+paris+chocolates+OR+flowers |
Suchbegriff ausschließen [-] | |
---|---|
Beschreibung | Der Begriff „Ausschließen“ ( Die URL-Version von Der Begriff „Ausschließen“ ist nützlich, wenn ein Suchbegriff mehr als eine Bedeutung hat. Zum Beispiel könnte das Wort „Barsch“ Ergebnisse zu Fisch oder Musik zurückgeben. Wenn Sie nach Dokumenten über Fisch suchen, können Sie Dokumente über Musik aus den Suchergebnissen ausschließen, indem Sie den Suchbegriff „Ausschließen“ verwenden. Sie können auch den Anfrageparameter as_eq verwenden, um Dokumente, die mit einem bestimmten Wort oder einer bestimmten Wortgruppe übereinstimmen, aus den Suchergebnissen auszuschließen. |
Beispiele | Nutzereingabe: bass -music Suchbegriff: q=bass+%2Dmusic |
Ausschluss von Dateitypen [ -filetype: ] | |
---|---|
Beschreibung | Der Abfragebegriff Die URL-Version von Hinweis: Sie können mehrere Dateitypen aus den Suchergebnissen ausschließen, indem Sie Ihrer Abfrage weitere Google unterstützt u. a. die folgenden Dateitypen:
In Zukunft werden möglicherweise weitere Dateitypen hinzugefügt. Eine aktuelle Liste finden Sie jederzeit in den FAQ zu Dateitypen von Google. |
Beispiele | In diesem Beispiel werden Dokumente zurückgegeben, in denen „Google“ erwähnt wird, die aber keine PDF-Dokumente sind: In diesem Beispiel werden Dokumente zurückgegeben, in denen „Google“ erwähnt wird, aber sowohl PDF- als auch Word-Dokumente ausgeschlossen sind: |
Dateitypfilterung [ filetype: ] | |
---|---|
Beschreibung | Der Abfragebegriff Die URL-Version von Sie können die Suchergebnisse auf Dokumente beschränken, die mit einer von mehreren Dateiendungen übereinstimmen. Fügen Sie dazu Ihrer Abfrage weitere Standardmäßig enthalten die Suchergebnisse Dokumente mit einer beliebigen Dateiendung. Google unterstützt u. a. die folgenden Dateitypen:
In Zukunft werden möglicherweise weitere Dateitypen hinzugefügt. Eine aktuelle Liste finden Sie jederzeit in den FAQ zu Dateitypen von Google. |
Beispiele | In diesem Beispiel werden PDF-Dokumente zurückgegeben, in denen „Google“ erwähnt wird: Dieses Beispiel gibt PDF- und Word-Dokumente zurück, in denen „Google“ erwähnt wird: |
Suchbegriff einschließen [+] | |
---|---|
Beschreibung | Der Suchbegriff „Einschließen“ (+) gibt an, dass ein Wort oder eine Wortgruppe in allen Dokumenten enthalten sein muss, die in den Suchergebnissen enthalten sind. Wenn Sie den Suchbegriff „Einschließen“ verwenden möchten, stellen Sie dem Wort oder der Wortgruppe, die in allen Suchergebnissen enthalten sein müssen, ein Pluszeichen „+“ voran. Die URL-Escaping-Version von Verwende |
Beispiele | Nutzereingabe: Star Wars Episode +I Suchbegriff: q=Star+Wars+Episode+%2BI |
Nur Suche nach Links, alle Begriffe [ allinlinks: ] | |
---|---|
Beschreibung | Für den Wenn deine Suchanfrage den Suchbegriff Die URL-Version von |
Beispiele | Nutzereingabe:allinlinks: Google search Suchbegriff: q=allinlinks%3A+Google+search |
Wortgruppensuche | |
---|---|
Beschreibung | Mit dem Suchbegriff „Passende Wortgruppe“ (“) können Sie nach vollständigen Wortgruppen suchen, indem Sie sie in Anführungszeichen setzen oder mit Bindestrichen verbinden. Die URL-Version von Die Suche nach Wortgruppen ist besonders nützlich, wenn Sie nach berühmten Zitaten oder Eigennamen suchen. Sie können auch den Anfrageparameter as_epq verwenden, um eine Wortgruppensuche zu senden. |
Beispiele | Nutzereingabe:"Abraham Lincoln" Suchbegriff: q=%22Abraham+Lincoln%22 |
Nur Textsuche, alle Begriffe [allintext:] | |
---|---|
Beschreibung | Für den Wenn Ihre Suchanfrage den Suchbegriff Die URL-Version von |
Beispiele | In diesem Beispiel wird angegeben, dass die Wörter „Google“ und „Suche“ im Text aller Dokumente in den Suchergebnissen enthalten sein müssen: Nutzereingabe: allintext:Google search Suchbegriff: q=allintext%3AGoogle+search |
Titelsuche, Einzelbegriff [intitle:] | |
---|---|
Beschreibung | Der Abfragebegriff Hinweis: Sie können mehr als ein Wort angeben, das im Dokumenttitel enthalten sein muss. Dazu stellen Sie den Suchbegriff Die URL-Version von |
Beispiele | In diesem Beispiel wird angegeben, dass das Wort „Google“ in den Titeln aller Dokumente in den Suchergebnissen enthalten sein muss und das Wort „Suche“ an beliebiger Stelle im Titel, in den URLs, Links oder im Text dieser Dokumente enthalten sein muss: |
Titelsuche, alle Begriffe [allintitle:] | |
---|---|
Beschreibung | Der Abfragebegriff Hinweis:Wenn du Die URL-Escaping-Version von |
Beispiele | In diesem Beispiel wird angegeben, dass die Wörter „Google“ und „Suche“ in den Titeln der Dokumente in den Suchergebnissen enthalten sein müssen: |
URL-Suche, einzelner Begriff [inurl:] | |
---|---|
Beschreibung | Der Abfragebegriff Der Die URL-Version von |
Beispiele | In diesem Beispiel wird angegeben, dass das Wort „Google“ in den URLs aller Dokumente in den Suchergebnissen enthalten sein muss und das Wort „Suche“ an beliebiger Stelle im Titel, in den URLs, Links oder im Text dieser Dokumente enthalten sein muss: |
URL-Suche, alle Begriffe [allinurl:] | |
---|---|
Beschreibung | Der Abfragebegriff Der Die URL-Version von |
Beispiele | In diesem Beispiel wird angegeben, dass die Wörter „Google“ und „Suche“ in den URLs aller Dokumente in den Suchergebnissen enthalten sein müssen: |
Informationen zu Webdokumenten [info:] | |
---|---|
Beschreibung | Mit dem Abfragebegriff Die URL-Escaping-Version von Hinweis: Sie können keine anderen Suchbegriffe angeben, wenn Sie |
Beispiele | Nutzereingabe: info:www.google.com Suchbegriff: q=info%3Awww.google.com |
Beispielabfragen für Bilder
Die folgenden Beispiele zeigen einige Bild-HTTP-Anfragen, um die Verwendung verschiedener Abfrageparameter zu veranschaulichen. Definitionen für die verschiedenen Suchparameter finden Sie in diesem Dokument in den Abschnitten zu den Definitionen der Suchparameter für Bilder.
In dieser Anfrage werden die ersten fünf Ergebnisse (start=0&num=5
) für den Suchbegriff „Affe“ (q=monkey
) mit dem Dateityp „.png“ angefordert. Schließlich gibt die Abfrage Werte für die Parameter client
, output
und cx
an, die alle drei erforderlich sind.
http://www.google.com/cse? searchtype=image start=0 &num=5 &q=monkey &as_filetype=png &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
Suchparameter für die Bildersuche
as_filetype | |
---|---|
Beschreibung | Optional: Gibt Bilder eines angegebenen Typs zurück. Zulässige Werte sind: |
Beispiele | q=google&as_filetype=png |
imgsz | |
---|---|
Beschreibung | Optional: Gibt Bilder einer bestimmten Größe zurück, wobei die Größe einer der folgenden Werte sein kann:
|
Beispiele | q=google&as_filetype=png&imgsz=icon |
imgtype | |
---|---|
Beschreibung | Optional: Gibt Bilder eines Typs zurück. Dabei kann es sich um einen der folgenden Typen handeln:
|
Beispiele | q=google&as_filetype=png&imgtype=photo |
imgc | |
---|---|
Beschreibung | Optional: Gibt Schwarz-Weiß-, Graustufen- oder Farbbilder zurück:
|
Beispiele | q=google&as_filetype=png&imgc=gray |
imgcolor | |
---|---|
Beschreibung | Optional: Gibt Bilder einer bestimmten dominanten Farbe zurück:
|
Beispiele | q=google&as_filetype=png&imgcolor=yellow |
as_rights | |
---|---|
Beschreibung | Optional: Filter sind lizenzbasiert. Unterstützte Werte sind:
|
Beispiele | q=cats&as_filetype=png&as_rights=cc_attribute |
Anfragelimits
In der folgenden Tabelle sind die Einschränkungen für die Suchanfragen aufgeführt, die du an Google sendest:
Komponente | Limit | Kommentar |
---|---|---|
Länge der Suchanfrage | 2.048 Byte | |
Anzahl der Suchbegriffe | 10 | enthält Begriffe in den folgenden Parametern: q, as_epq, as_eq, as_lq, as_oq, as_q |
Anzahl der Ergebnisse | 20 | Wenn Sie den Parameter num auf eine Zahl größer als 20 setzen, werden nur 20 Ergebnisse zurückgegeben. Um mehr Ergebnisse zu erhalten, müssten Sie mehrere Anfragen senden und den Wert des Parameters start bei jeder Anfrage erhöhen. |
Abfrage und Ergebnispräsentation internationalisieren
Mit Google WebSearch können Sie nach Dokumenten in mehreren Sprachen suchen. Sie können die Zeichencodierung angeben, die zum Interpretieren Ihrer HTTP-Anfrage und zum Codieren Ihrer XML-Antwort verwendet werden soll. Verwenden Sie dazu die Suchparameter ie und oe. Sie können die Ergebnisse auch so filtern, dass nur Dokumente in bestimmten Sprachen enthalten sind.
In den folgenden Abschnitten werden Probleme bei der Suche in mehreren Sprachen erläutert:
Zeichencodierung
Server senden Daten wie Webseiten als Folge codierter Byte an User-Agents wie Browser. Der User-Agent decodiert dann die Byte in eine Zeichenfolge. Wenn Sie Anfragen an den WebSearch-Dienst senden, können Sie die Codierungsschemas sowohl für Ihre Suchanfrage als auch für die XML-Antwort angeben, die Sie erhalten.
Mit dem Anfrageparameter ie können Sie den Codierungsmechanismus für die Zeichen in Ihrer HTTP-Anfrage angeben. Mit dem Parameter oe können Sie auch das Codierungsschema angeben, das Google zum Codieren Ihrer XML-Antwort verwenden soll. Wenn Sie ein anderes Codierungsschema als ISO-8859-1
(oder latin1
) verwenden, müssen Sie die richtigen Werte für die Parameter ie und oe angeben.
Hinweis:Wenn Sie Suchfunktionen für mehrere Sprachen bereitstellen, empfehlen wir die Verwendung des Codierungswerts utf8
(UTF-8) für die Parameter ie und oe.
Im Anhang Zeichencodierungsschemata finden Sie eine vollständige Liste der Werte, die Sie für die Parameter ie und oe verwenden können.
Allgemeine Informationen zur Zeichencodierung finden Sie unter http://www.w3.org/TR/REC-html40/charset.html.
Sprachen der Benutzeroberfläche
Mit dem Anfrageparameter hl können Sie die Sprache Ihrer grafischen Benutzeroberfläche angeben. Der Parameterwert hl kann sich auf XML-Suchergebnisse auswirken, insbesondere bei internationalen Abfragen, wenn die Sprachbeschränkung (mithilfe des Parameters lr) nicht explizit angegeben wurde. In diesem Fall können Suchergebnisse durch den Parameter hl in derselben Sprache wie die Eingabesprache des Nutzers angezeigt werden.
Wir empfehlen, den hl-Parameter in den Suchergebnissen explizit festzulegen, damit Google für jede Suchanfrage die qualitativ hochwertigsten Suchergebnisse auswählt.
Eine vollständige Liste der gültigen Werte für den Parameter hl finden Sie im Abschnitt Unterstützte Oberflächensprachen.
Nach Dokumenten in bestimmten Sprachen suchen
Mit dem Anfrageparameter lr können Sie die Suchergebnisse auf Dokumente beschränken, die in einer bestimmten Sprache oder einer Gruppe von Sprachen geschrieben sind.
Der Parameter lr unterstützt Boolesche Operatoren, mit denen Sie mehrere Sprachen angeben können, die in den Suchergebnissen berücksichtigt oder davon ausgeschlossen werden sollen.
Die folgenden Beispiele zeigen, wie Sie Boolesche Operatoren verwenden können, um Dokumente in verschiedenen Sprachen anzufordern.
Für japanische Dokumente:
lr=lang_jp
Für Dokumente in italienischer oder deutscher Sprache:
lr=lang_it|lang_de
Für Dokumente, die nicht auf Ungarisch oder Tschechisch verfasst sind:
lr=(-lang_hu).(-lang_cs)
Im Abschnitt Werte für die Spracherfassung finden Sie eine vollständige Liste der möglichen Werte für den Parameter lr und die Abschnitte Boolesche Operatoren. Dort finden Sie eine umfassende Beschreibung der Verwendung dieser Operatoren.
Suche auf Chinesisch (vereinfacht und traditionell)
Vereinfachtes Chinesisch und traditionelles Chinesisch sind zwei Schriftvarianten des Chinesischs. Dasselbe Konzept kann in jeder Variante unterschiedlich geschrieben werden. Bei einer Suchanfrage in einer der Varianten kann der Google WebSearch-Dienst Ergebnisse zurückgeben, die Seiten in beiden Varianten enthalten.
So verwenden Sie dieses Feature:
- Setzen Sie den Anfrageparameter c2coff auf 0
und - Führen Sie einen der folgenden Schritte aus:
Das folgende Beispiel zeigt die Abfrageparameter, die Sie in eine Ergebnisanfrage in vereinfachtem und traditionellem Chinesisch einschließen würden. Zusätzliche erforderliche Informationen wie der client sind im Beispiel nicht enthalten.
search?hl=zh-CN &lr=lang_zh-TW|lang_zh-CN &c2coff=0
Ergebnisse filtern
Mit Google WebSearch haben Sie mehrere Möglichkeiten, Ihre Suchergebnisse zu filtern:
- Suchergebnisse automatisch filtern
- Nach Sprache und Land filtern
- Inhalte nur für Erwachsene mit SafeSearch filtern
Automatisches Filtern von Suchergebnissen
Im Rahmen unserer Bemühungen, die bestmöglichen Suchergebnisse zu liefern, verwendet Google zwei Verfahren, um allgemein als unerwünscht geltende Suchergebnisse automatisch zu filtern:
-
Duplizierte Inhalte – Wenn mehrere Dokumente dieselben Informationen enthalten, wird nur das relevanteste Dokument dieses Satzes in die Suchergebnisse einbezogen.
-
Host-Crowding: Wenn viele Suchergebnisse von derselben Website vorliegen, werden unter Umständen nicht alle Ergebnisse von dieser Website angezeigt oder die Ergebnisse werden im Ranking weiter unten
angezeigt, als dies sonst der Fall gewesen wäre.
Wir empfehlen, diese Filter für typische Suchanfragen aktiviert zu lassen, da sie die Qualität der meisten Suchergebnisse erheblich verbessern. Sie können diese automatischen Filter jedoch umgehen, indem Sie den Abfrageparameter filter in der Suchanfrage auf 0 setzen.
Nach Sprache und Land filtern
Der Google WebSearch-Dienst gibt Ergebnisse aus einem Masterindex aller Webdokumente zurück. Der Masterindex enthält untergeordnete Sammlungen von Dokumenten, die nach bestimmten Attributen gruppiert sind, darunter Sprache und Ursprungsland.
Sie können die Anfrageparameter lr und cr verwenden, um Suchergebnisse auf untergeordnete Sammlungen von Dokumenten zu beschränken, die in bestimmten Sprachen geschrieben sind oder aus bestimmten Ländern stammen.
Die Sprache eines Dokuments wird mit Google WebSearch anhand folgender Daten bestimmt:
- die Top-Level-Domain (TLD) der Dokument-URL
- Meta-Tags für die Sprache innerhalb des Dokuments
- die im Textkörper des Dokuments verwendete Hauptsprache
Weitere Informationen zum Einschränken von Ergebnissen nach Sprache finden Sie auch in der Definition des Parameters lr, im Abschnitt zum Suchen nach Dokumenten in bestimmten Sprachen und in den Werten für die Spracherfassung, die als Werte für den Parameter lr verwendet werden können.
Google WebSearch ermittelt das Land eines Dokuments durch die Analyse:
- die Top-Level-Domain (TLD) der Dokument-URL
- den geografischen Standort der IP-Adresse des Webservers
Weitere Informationen zum Einschränken von Ergebnissen nach Herkunftsland finden Sie in der Definition des Parameters cr und der Werte für die Ländersammlung, die als Werte für den Parameter cr verwendet werden können.
Hinweis:Sie können Sprach- und Länderwerte kombinieren, um Ihre Suchergebnisse anzupassen. Sie können beispielsweise Dokumente in französischer Sprache anfordern, die aus Frankreich oder Kanada stammen, oder Dokumente aus den Niederlanden, die nicht auf Englisch verfasst sind. Die Parameter lr und cr unterstützen beide Boolesche Operatoren.
Nicht jugendfreie Inhalte mit SafeSearch filtern
Viele Google-Kunden möchten keine Suchergebnisse für Websites mit Inhalten nur für Erwachsene anzeigen. Mit unserem SafeSearch-Filter kannst du Suchergebnisse mit Inhalten nur für Erwachsene herausfiltern und ausschließen. Die Filter von Google nutzen eigene Technologien, um Keywords, Wortgruppen und URLs zu überprüfen. Zwar sind keine Filter zu 100 % genau, SafeSearch entfernt jedoch den Großteil der Inhalte nur für Erwachsene aus deinen Suchergebnissen.
Google ist bestrebt, SafeSearch so aktuell und umfassend wie möglich zu gestalten. Dazu werden fortlaufend das Web gecrawlt und Aktualisierungen aus Nutzervorschlägen übernommen.
SafeSearch ist in den folgenden Sprachen verfügbar:
Niederländisch Englisch Französisch Deutsch |
Italienisch Portugiesisch (Brasilien) Spanisch Chinesisch (traditionell) |
Mit dem Abfrageparameter safe können Sie einstellen, inwieweit Google Ihre Ergebnisse für Inhalte nur für Erwachsene filtert. In der folgenden Tabelle werden die SafeSearch-Einstellungen von Google und ihre Auswirkungen auf die Suchergebnisse erläutert:
SafeSearch-Ebene | Beschreibung |
---|---|
hoch | Aktiviert eine strengere Version von SafeSearch. |
medium | Blockiert Webseiten, die Pornografie und andere explizite sexuelle Inhalte enthalten. |
deaktiviert | Inhalte nur für Erwachsene werden nicht aus den Suchergebnissen herausgefiltert. |
* Die SafeSearch-Standardeinstellung ist deaktiviert.
Wenn Sie SafeSearch aktiviert haben und in Ihren Ergebnissen Websites mit anstößigen Inhalten finden, senden Sie eine E-Mail mit der URL der Website an safesearch@google.com. Wir werden die Website dann untersuchen.
XML-Ergebnisse
- Google-XML-Ergebnis-DTD
- Informationen zur XML-Antwort
- XML-Ergebnisse für reguläre und erweiterte Suchanfragen
- Reguläre/erweiterte Suche: Beispielabfrage und XML-Ergebnis
- Normale/erweiterte Suche: XML-Tags
DTD mit Google XML-Ergebnissen
Google verwendet dieselbe DTD, um das XML-Format für alle Arten von Suchergebnissen zu beschreiben. Viele Tags und Attribute gelten für alle Suchtypen. Einige Tags gelten jedoch nur für bestimmte Suchtypen. Daher können die Definitionen in der DTD weniger restriktiv sein als die Definitionen in diesem Dokument.
In diesem Dokument werden die Aspekte der DTD beschrieben, die für WebSearch relevant sind. Wenn Sie sich die DTD ansehen und an WebSearch arbeiten, können Sie Tags und Attribute bedenkenlos ignorieren, die hier nicht dokumentiert sind. Wenn sich die Definition zwischen der DTD und der Dokumentation unterscheidet, ist dies in diesem Dokument angegeben.
Google kann XML-Ergebnisse entweder mit oder ohne Verweis auf die neueste DTD zurückgeben. Das DTD ist ein Leitfaden, der Suchadministratoren und XML-Parser dabei unterstützt, die XML-Ergebnisse von Google zu verstehen. Da sich die XML-Grammatik von Google von Zeit zu Zeit ändern kann, sollten Sie Ihren Parser nicht für die Verwendung der DTD zur Validierung jedes XML-Ergebnisses konfigurieren.
Außerdem sollten Sie Ihren XML-Parser nicht so konfigurieren, dass er die DTD bei jeder Übermittlung einer Suchanfrage abruft. Google aktualisiert die DTD nur selten und diese Anfragen verursachen unnötige Verzögerungs- und Bandbreitenanforderungen.
Google empfiehlt für XML-Ergebnisse die Verwendung des Ausgabeformats xml_no_dtd. Wenn Sie in Ihrer Suchanfrage das Ausgabeformat xml output angeben, besteht der einzige Unterschied darin, dass folgende Zeile in die XML-Ergebnisse aufgenommen wird:
<!DOCTYPE GSP SYSTEM "google.dtd">
Die neueste DTD finden Sie unter http://www.google.com/google.dtd.
Bitte beachte, dass zu diesem Zeitpunkt möglicherweise nicht alle Funktionen der DTD verfügbar oder unterstützt werden.
Informationen zur XML-Antwort
- Alle Elementwerte sind gültigen HTML-Code und können angezeigt werden, sofern in den XML-Tag-Definitionen nichts anderes angegeben ist.
- Einige Elementwerte sind URLs, die HTML-codiert werden müssen, bevor sie angezeigt werden.
- Der XML-Parser sollte nicht dokumentierte Attribute und Tags ignorieren. So kann Ihre Anwendung ohne Änderungen weiterarbeiten, wenn Google der XML-Ausgabe weitere Funktionen hinzufügt.
- Bestimmte Zeichen müssen mit Escapezeichen versehen werden, wenn sie als Werte in XML-Tags enthalten sind. Der XML-Prozessor sollte diese Entitäten wieder in die entsprechenden Zeichen konvertieren. Wenn Sie Entitäten nicht ordnungsgemäß konvertieren, kann der Browser beispielsweise das &-Zeichen als "&" rendern.
Im XML-Standard werden diese Zeichen dokumentiert. Sie werden in der folgenden Tabelle wiedergegeben:
Figur Formulare mit Escape-Zeichen Entität Zeichencode Kaufmännisches Und-Zeichen & & - Einfaches Anführungszeichen ' ' ' Doppeltes Anführungszeichen " " 34; Größer-als-Zeichen > > > Kleiner-als-Zeichen < < -
XML-Ergebnisse für reguläre und erweiterte Suchanfragen
Normale/erweiterte Suche: Beispielabfrage und XML-Ergebnis
In dieser Beispiel-WebSearch-Anfrage werden zehn Ergebnisse (num=10
) zum Suchbegriff „socer“ (q=socer
) angefordert, der in diesem Beispiel absichtlich falsch geschrieben wurde.
http://www.google.com/search?
q=socer
&hl=en
&start=10
&num=10
&output=xml
&client=google-csbe
&cx=00255077836266642015:u-scht7a-8i
Diese Anfrage liefert das unten stehende XML-Ergebnis. Das XML-Ergebnis enthält mehrere Kommentare, die angeben, wo bestimmte, nicht im Ergebnis enthaltene Tags erscheinen würden.
<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>
<GSP VER="3.2">
<TM>0.452923</TM>
<Q>socer</Q>
<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
<PARAM name="hl" value="en" original_value="en"/>
<PARAM name="q" value="socer" original_value="socer"/>
<PARAM name="output" value="xml" original_value="xml"/>
<PARAM name="client" value="google-csbe" original_value="google-csbe"/>
<PARAM name="num" value="10" original_value="10"/>
<Spelling>
<Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
</Spelling>
<Context>
<title>Sample Vacation CSE</title>
<Facet>
<FacetItem>
<label>restaurants</label>
<anchor_text>restaurants</anchor_text>
</FacetItem>
<FacetItem>
<label>wineries</label>
<anchor_text>wineries</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>golf_courses</label>
<anchor_text>golf courses</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>hotels</label>
<anchor_text>hotels</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>nightlife</label>
<anchor_text>nightlife</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>soccer_sites</label>
<anchor_text>soccer sites</anchor_text>
</FacetItem>
</Facet>
</Context>
<RES SN="1" EN="10">
<M>6080</M>
/*
* The FI tag after the comment indicates that the result
* set has been filtered. If the number of results were exact, the
* FI tag would be replaced by an XT tag in the same format.
*/
<FI />
<NB>
/*
* Since the request is for the first page of results, the PU tag,
* which contains a link to the previous page of search results,
* is not included in this XML result. If the sample result did include
* a previous page of results, it would be listed here, in the same format
* as the NU tag on the following line
*/
<NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
</NB>
<R N="1">
<U>http://www.soccerconnection.net/</U>
<UE>http://www.soccerconnection.net/</UE>
<T>SoccerConnection.net</T>
<CRAWLDATE>May 21, 2007</CRAWLDATE>
<S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
<Label>transcodable_pages</Label>
<Label>accessible</Label>
<Label>soccer_sites</Label>
<LANG>en</LANG>
<HAS>
<DI>
<DT>SoccerConnection.net</DT>
<DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
</DI>
<L/>
<C SZ="8k" CID="kWAPoYw1xIUJ"/>
<RT/>
</HAS>
</R>
/*
* The result includes nine more results, each enclosed by an R tag.
*/
</RES>
</GSP>
Normale/erweiterte Suche: XML-Tags
XML-Antworten auf reguläre und erweiterte Suchanfragen verwenden beide denselben Satz von XML-Tags. Diese XML-Tags werden im XML-Beispiel oben dargestellt und in den folgenden Tabellen erläutert.
Die unten aufgeführten XML-Tags sind alphabetisch nach Tag-Namen aufgeführt. Jede Tag-Definition enthält eine Beschreibung des Tags und ein Beispiel, das zeigt, wie das Tag in einem XML-Ergebnis aussehen würde und welches Format des Inhalts des Tags vorliegt. Wenn das Tag ein Subtag eines anderen XML-Tags ist oder wenn das Tag eigene Untertags oder Attribute hat, werden diese Informationen auch in der Definitionstabelle des Tags bereitgestellt.
In den Definitionen unten können neben einigen Subtags bestimmte Symbole angezeigt werden. Diese Symbole haben folgende Bedeutungen:
* = keine oder mehrere Instanzen des Subtags
+ = eine oder mehrere Instanzen des Subtags
V | B | C | D | F | G | I | M | N | P | F | R | S | T | U | X |
anchor_text | |
---|---|
Definition | Das Tag <anchor_text> gibt den Text an, der Nutzern angezeigt werden soll, um ein mit einem Suchergebnis verknüpftes Suchlabel zu identifizieren. Da Suchfilter-Labels nicht alphanumerische Zeichen durch Unterstriche ersetzen, sollten Sie den Wert des Tags <label> in Ihrer Benutzeroberfläche nicht anzeigen. Stattdessen sollten Sie den Wert des Tags <anchor_text> anzeigen. |
Beispiel | <anchor_text>Golfplätze</anchor_text> |
Subtag von | FacetItem |
Inhaltsformat | Text |
BLOCKIEREN | |
---|---|
Definition | Dieses Tag schließt den Inhalt eines Blocks in einer Textzeile eines Werbeergebnisses ein. Jeder Block hat die Untertags T, U und L. Ein nicht leeres T-Tag gibt an, dass der Block Text enthält. Nicht leere U- und L-Tags geben an, dass der Block einen Link enthält (mit der URL im U-Subtag und Ankertext im L-Subtag). |
Subtags | T, U, L |
Subtag von | BODY_LINE |
Inhaltsformat | Leer |
BODY_LINE | |
---|---|
Definition | Dieses Tag schließt den Inhalt einer Zeile im Text des beworbenen Ergebnisses ein. Jede Textzeile besteht aus mehreren BLOCK-Tags, die entweder etwas Text oder einen Link mit URL und Ankertext enthalten. |
Subtags | BLOCKIEREN* |
Subtag von | SL_MAIN |
Inhaltsformat | Leer |
C | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definition | Das <C>-Tag gibt an, dass der WebSearch-Dienst eine im Cache gespeicherte Version dieser Suchergebnis-URL abrufen kann. Im Cache gespeicherte Seiten lassen sich nicht über die XML API abrufen. Sie haben aber die Möglichkeit, Nutzer für diese Inhalte an www.google.com weiterzuleiten. |
|||||||||
Attributes |
|
|||||||||
Beispiel | <C SZ="6k" CID="kvOXK_cYSSgJ" /> | |||||||||
Subtag von | HAS | |||||||||
Inhaltsformat | Leer |
C2C | |
---|---|
Definition | Das <C2C>-Tag gibt an, dass sich das Ergebnis auf eine Seite in traditionellem Chinesisch bezieht. Dieses Tag wird nur angezeigt, wenn Chinesisch (vereinfacht und traditionell) aktiviert ist. Weitere Informationen zum Aktivieren und Deaktivieren dieser Funktion finden Sie in der Definition des Abfrageparameters c2coff. |
Inhaltsformat | Text |
Kontext | |
---|---|
Definition | Das Tag <Context> enthält eine Liste von Labels zur Optimierung, die mit einer Reihe von Suchergebnissen verknüpft sind. |
Beispiel | <Context> |
Subtags | title, Facet+ |
Inhaltsformat | Container |
CRAWLDATE | |
---|---|
Definition | Das <CRAWLDATE>-Tag gibt das Datum an, an dem die Seite zuletzt gecrawlt wurde. |
Beispiel | <CRAWLDATE>21. Mai 2005</CRAWLDATE> |
Subtag von | R |
Inhaltsformat | Text |
DI | |
---|---|
Definition | Das <DI>-Tag kapselt Informationen zur Open Directory Project-(ODP)-Kategorie für ein einzelnes Suchergebnis. |
Beispiel | <DI> |
Subtags | DT?, DS? |
Subtag von | HAS |
Inhaltsformat | Leer |
DS | |
---|---|
Definition | Das Tag <DS> liefert die Zusammenfassung für eine einzelne Kategorie im ODP-Verzeichnis. |
Beispiel | <DS>Posten Sie Ihren Lebenslauf für <b>Fußball</b> direkt im Internet.</DS> |
Subtag von | DI |
Inhaltsformat | Text (kann HTML enthalten) |
Gerätebaum | |
---|---|
Definition | Das Tag <DT> liefert den Titel für eine einzelne Kategorie, die im ODP-Verzeichnis aufgeführt ist. |
Beispiel | <DT>SoccerConnection.net</DT> |
Subtag von | DI |
Inhaltsformat | Text (kann HTML enthalten) |
Attribut | |
---|---|
Definition | Das <Facet>-Tag enthält eine logische Gruppierung von <FacetItem>-Tags. Sie können diese Gruppierungen mit dem XML-Spezifikationsformat der Programmable Search Engine erstellen. Wenn Sie diese Gruppierungen nicht erstellen, enthält das Tag results_xml_tag_Context><Context> bis zu vier <Facet>-Tags. Die Elemente in jedem <Facet>-Tag werden zu Anzeigezwecken gruppiert, haben aber möglicherweise keine logische Beziehung. |
Beispiel | <Facet> |
Subtags | FacetItem+, title+ |
Subtag von | Kontext |
Inhaltsformat | Container |
FacetItem | |
---|---|
Definition | Das Tag <FacetItem> enthält Informationen zu einem Suchfilter-Label, das mit einer Reihe von Suchergebnissen verknüpft ist. |
Beispiel | <FacetItem> |
Subtags | label, anchor_text+ |
Subtag von | Attribut |
Inhaltsformat | FacetItem |
FI | |
---|---|
Definition | Das Tag <FI> dient als Flag, das angibt, ob für die Suche eine Dokumentfilterung durchgeführt wurde. Weitere Informationen zu den Suchergebnisfiltern von Google finden Sie im Abschnitt Automatische Filterung in diesem Dokument. |
Beispiel | <FI /> |
Subtag von | RES |
Inhaltsformat | Leer |
Gesponserte Werbung in Gmail | |||||||
---|---|---|---|---|---|---|---|
Definition | Das <GSP>-Tag enthält alle Daten, die in den XML-Suchergebnissen von Google zurückgegeben werden. „GSP“ ist eine Abkürzung für „Google Search Protocol“. |
||||||
Attributes |
|
||||||
Beispiel | <GSP VER="3.2"> | ||||||
Subtags | PARAM+, Q, RES?, TM | ||||||
Inhaltsformat | Leer |
HAS | |
---|---|
Definition | Das <HAS>-Tag enthält Informationen zu speziellen Suchanfrageparametern, die für eine bestimmte URL unterstützt werden.
Hinweis:Die Definition von <HAS> für WebSearch ist restriktiver als in der DTD. |
Subtags | DI?, L?, C?, RT? |
Subtag von | R |
ISURL | |
---|---|
Definition | Google gibt das <ISURL>-Tag zurück, wenn die zugehörige Suchanfrage eine URL ist. |
Subtag von | GSP |
Inhaltsformat | Leer |
L | |
---|---|
Definition | Wenn das <L>-Tag vorhanden ist, kann der WebSearch-Dienst andere Websites finden, die Links zu dieser Suchergebnis-URL enthalten. Um solche Websites zu finden, würden Sie den speziellen Suchbegriff link: verwenden. |
Subtag von | HAS |
Inhaltsformat | Leer |
Label | |
---|---|
Definition | Das <label>-Tag gibt ein Label für den Suchfilter an, mit dem Sie die Suchergebnisse filtern können. Wenn Sie ein Suchfilter-Label verwenden möchten, fügen Sie dem Wert des Parameters q in Ihrer HTTP-Anfrage an Google den String more:[[label tag value]] hinzu, wie im folgenden Beispiel gezeigt. Beachten Sie, dass dieser Wert URL-Escaping sein muss, bevor Sie die Anfrage an Google senden. This example uses the refinement label golf_courses to Hinweis:Das <label>-Tag ist nicht mit dem <Label>-Tag identisch, mit dem ein Suchfilter-Label identifiziert wird, das mit einer bestimmten URL in Ihren Suchergebnissen verknüpft ist. |
Beispiel | <label>golfplätze</label> |
Subtag von | FacetItem |
Inhaltsformat | Text |
lang | |
---|---|
Definition | Das Tag <LANG> enthält die bestmögliche Vermutung über die Sprache des Suchergebnisses durch Google. |
Beispiel | <LANG>en</LANG> |
Subtag von | R |
Inhaltsformat | Text |
M | |
---|---|
Definition | Das <M>-Tag gibt die geschätzte Gesamtzahl der Ergebnisse für die Suche an. Hinweis : Diese Schätzung ist möglicherweise nicht korrekt. |
Beispiel | <M>16200000</M> |
Subtag von | RES |
Inhaltsformat | Text |
Neugeborene | |
---|---|
Definition | Das <NB>-Tag enthält Navigationsinformationen für den Ergebnissatz, also Links zur nächsten Suchergebnisseite oder zur vorherigen Suchergebnisseite. Hinweis:Dieses Tag ist nur vorhanden, wenn mehr Ergebnisse verfügbar sind. |
Beispiel | <NB> |
Subtags | NU?, Verarbeitungseinheit? |
Subtag von | RES |
Inhaltsformat | Leer |
NU | |
---|---|
Definition | Das <NU>-Tag enthält einen relativen Link zur nächsten Suchergebnisseite. |
Beispiel | <NU>/search?q=flowers&num=10&hl=de&ie=UTF-8 &output=xml&client=test&start=10</NU> |
Subtag von | Hinweis |
Inhaltsformat | Text (relative URL) |
PARAM | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Definition | Das Tag <PARAM> gibt einen Eingabeparameter an, der in der mit dem XML-Ergebnis verknüpften HTTP-Anfrage gesendet wurde. Informationen zum Parameter sind in den Tag-Attributen „name“, „value“ und „original_value“ enthalten. Für jeden in der HTTP-Anfrage gesendeten Parameter gibt es ein PARAM-Tag. |
||||||||||||
Attributes |
|
||||||||||||
Beispiel | <PARAM name="cr" value="countryNZ" original_value="countryNZ" /> | ||||||||||||
Subtag von | GSP | ||||||||||||
Inhaltsformat | Komplex |
Verarbeitungseinheit | |
---|---|
Definition | Das <PU>-Tag stellt einen relativen Link zur vorherigen Suchergebnisseite bereit. |
Beispiel | <PU>/search?q=blumen&num=10&hl=de&output=xml &client=test&start=10</PU> |
Subtag von | Hinweis |
Inhaltsformat | Text (relative URL) |
F | |
---|---|
Definition | Das <Q>-Tag gibt die Suchanfrage an, die in der mit dem XML-Ergebnis verknüpften HTTP-Anfrage gesendet wurde. |
Beispiel | <Q>pizza</Q> |
Subtag von | GSP |
Inhaltsformat | Text |
R | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definition | Das <R>-Tag enthält die Details eines einzelnen Suchergebnisses. Hinweis:Die Definition des <R>-Tags für WebSearch ist restriktiver als in der DTD. |
|||||||||
Attributes |
|
|||||||||
Subtags | U, UE, T?, CRAWLDATE, S?, LANG?, HAS | |||||||||
Subtag von | RES |
WID | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definition | Das Tag <RES> schließt die Gruppe einzelner Suchergebnisse und Details zu diesen Ergebnissen ein. |
|||||||||
Attributes |
|
|||||||||
Beispiel | <RES SN="1" EN="10"> | |||||||||
Subtags | M, FI?, XT?, NB?, R* | |||||||||
Subtag von | GSP | |||||||||
Inhaltsformat | Leer |
S | |
---|---|
Definition | Das <S>-Tag enthält einen Auszug für ein Suchergebnis, in dem Suchbegriffe fett hervorgehoben sind. Der Auszug enthält Zeilenumbrüche für den richtigen Textumbruch. |
Beispiel | <S>Washington (CNN) -- Ein Gebot zur Beendigung der Einigung im Senat gegen Präsident <b>Bush's</b> Gerichtsentscheidungen würde fünf Nominierten zur endgültigen Abstimmung eintreten, wobei die Abstimmung |
Subtag von | R |
Inhaltsformat | Text (HTML) |
SL_MAIN | |
---|---|
Definition | Dieses Tag schließt den Inhalt eines Werbeergebnisses ein. Wird zum Parsen von Angeboten verwendet. Der Ankertext und die URL des Titellinks sind in den Untertags T bzw. U enthalten. Die Zeilen des Textkörpers und der Links sind in BODY_LINE-Subtags enthalten. |
Subtags | BODY_LINE*, T, U |
Subtag von | SL_RESULTS |
Inhaltsformat | Leer |
SL_RESULTS | |
---|---|
Definition | Container-Tag für beworbene Ergebnisse. Eine davon wird immer dann angezeigt, wenn Sie eine Werbung in Ihren Suchergebnissen haben. Das Subtag SL_MAIN enthält die Hauptergebnisdaten. |
Subtags | SL_MAIN* |
Subtag von | R |
Inhaltsformat | Leer |
Rechtschreibung | |
---|---|
Definition | Das Tag <Spelling> enthält einen alternativen Rechtschreibvorschlag für die eingereichte Abfrage. Dieses Tag erscheint nur auf der ersten Suchergebnisseite. Rechtschreibvorschläge sind auf Englisch, Chinesisch, Japanisch und Koreanisch verfügbar. Hinweis: Google gibt nur Rechtschreibvorschläge für Abfragen zurück, bei denen der Wert des Parameters gl in Kleinbuchstaben angegeben ist. |
Beispiel | <Spelling> |
Subtags | Vorschlag |
Subtag von | GSP |
Inhaltsformat | Leer |
Vorschlag | |||||||
---|---|---|---|---|---|---|---|
Definition | Das Tag <Suggest> enthält einen alternativen Rechtschreibvorschlag für die eingereichte Abfrage. Anhand des Tag-Inhalts kannst du dem Nutzer der Suche eine alternative Schreibweise vorschlagen. Der Wert des Attributs q ist der Rechtschreibvorschlag mit URL-Escaping, den Sie als Abfragebegriff verwenden können. | ||||||
Attributes |
|
||||||
Beispiel | <Vorschlag q="Fußball"><b><i>Fußball</i></b></Vorschlag> | ||||||
Subtag von | Rechtschreibung | ||||||
Inhaltsformat | Text (HTML) |
T | |
---|---|
Definition | Das <T>-Tag enthält den Titel des Ergebnisses. |
Beispiel | <T>Amici's East Coast Pizzeria</T> |
Subtag von | R |
Inhaltsformat | Text (HTML) |
title | |
---|---|
Definition | Als untergeordnetes Element von <Context> enthält das <title>-Tag den Namen Ihrer Programmable Search Engine. Als untergeordnetes Element von <Facet> liefert das <title>-Tag einen Titel für eine Reihe von Attributen. |
Beispiel | Als Kind von <Context>: <title>My Search Engine</title> Als untergeordnetes Element von <Facet>: <title>facet title</title> |
Subtag von | Kontext, Facette |
Inhaltsformat | Text |
TM | |
---|---|
Definition | Das <TM>-Tag gibt die gesamte Serverzeit an, die für die Ausgabe von Suchergebnissen benötigt wird, in Sekunden. |
Beispiel | <TM>0,100445</TM> |
Subtag von | GSP |
Inhaltsformat | Text (Gleitkommazahl) |
TT | |
---|---|
Definition | Das Tag <TT> enthält einen Tipps für die Suche. |
Beispiel | <TT><i>Tipp: Bei den meisten Browsern führt das Drücken der Eingabetaste zum gleichen Ergebnis wie das Klicken auf die Suchschaltfläche.</i></TT> |
Subtag von | GSP |
U | |
---|---|
Definition | Das <U>-Tag gibt die URL des Suchergebnisses an. |
Beispiel | <U>http://www.dominos.com/</U> |
Subtag von | R |
Inhaltsformat | Text (Absolute URL) |
UD | |
---|---|
Definition | Das <UD>-Tag gibt die IDN-codierte URL (International Domain Name) für das Suchergebnis an. Mit diesem Wert können Domains in lokalen Sprachen angezeigt werden. So könnte beispielsweise die IDN-codierte URL http://www.%E8%8A%B1%E4%BA%95.com decodiert und als http://www.花井鮨.com angezeigt werden. Dieses <UD>-Tag wird nur in die Suchergebnisse für Anfragen mit dem Parameter ud aufgenommen. Hinweis:Dies ist eine Betafunktion. |
Beispiel | <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD> |
Subtag von | R |
Inhaltsformat | Text (IDN-codierte URL) |
UE | |
---|---|
Definition | Das <UE>-Tag gibt die URL des Suchergebnisses an. Der Wert ist URL-Escaping und eignet sich daher zur Weitergabe als Abfrageparameter in einer URL. |
Beispiel | <UE>http://www.dominos.com/</UE> |
Subtag von | R |
Inhaltsformat | Text (URL-Escaping-URL) |
Logo: XT | |
---|---|
Definition | Das <XT>-Tag gibt an, dass die geschätzte Gesamtzahl der Ergebnisse, wie durch das Tag M angegeben, tatsächlich die genaue Gesamtzahl der Ergebnisse darstellt. Weitere Informationen finden Sie in diesem Dokument im Abschnitt Automatische Filterung. |
Beispiel | <XT /> |
Subtag von | RES |
Inhaltsformat | Leer |
XML-Ergebnisse für Bildersuchen
Bei dieser Beispielanfrage für ein Bild werden fünf Ergebnisse (num=5) zum Suchbegriff „Affe“ (q=Affe) angefordert.
http://www.google.com/cse? searchtype=image &num=2 &q=monkey &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
Diese Anfrage liefert das unten stehende XML-Ergebnis.
<GSP VER="3.2"> <TM>0.395037</TM> <Q>monkeys</Q> <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/> <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/> <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/> <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/> <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/> <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/> <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/> <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/> <Context> <title>domestigeek</title> </Context> <ARES/> <RES SN="1" EN="2"> <M>2500000</M> <NB> <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N </NU> </NB> <RG START="1" SIZE="2"/> <R N="1" MIME="image/jpeg"> <RU>http://www.flickr.com/photos/fncll/135465558/</RU> <U> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </U> <UE> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </UE> <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T> <RK>0</RK> <BYLINEDATE>1146034800</BYLINEDATE> <S>Computer <b>Monkeys</b> | Flickr</S> <LANG>en</LANG> <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"> <SZ>88386</SZ> <IN/> </IMG> <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi- t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/> </R> <R N="2" MIME="image/jpeg"> <RU> http://www.flickr.com/photos/flickerbulb/187044366/ </RU> <U> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </U> <UE> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </UE> <T> one. ugly. <b>monkey</b>. | Flickr - Photo Sharing! </T> <RK>0</RK> <BYLINEDATE>1152514800</BYLINEDATE> <S>one. ugly. <b>monkey</b>.</S> <LANG>en</LANG> <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw- EF4tQQnDDKOq0"><SZ>58339</SZ> <IN/> </IMG> <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/> </R> </RES> </GSP>
Bildersuche: XML-Tags
Die folgende Tabelle zeigt zusätzliche XML-Tags, die in XML-Antworten für Bildersuchanfragen verwendet werden.
In den Definitionen unten können neben einigen Subtags bestimmte Symbole angezeigt werden. Diese Symbole haben folgende Bedeutungen:
* = keine oder mehrere Instanzen des Subtags
+ = eine oder mehrere Instanzen des Subtags
Logo: RG | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
Definition | Das <RG>-Tag enthält die Details eines einzelnen Ergebnisses für die Bildersuche. |
|||||||||
Attributes |
| |||||||||
Subtag von | RES |
RU | |
---|---|
Definition | Das <RU tag>-Tag enthält Details zu jedem Bildsuchergebnis. |
Subtag von | R |