XML API-Referenz

Diese Seite bezieht sich auf die XML-Version der Custom Search JSON API, die nur für Nutzer von Google Site Search.

  1. Übersicht
  2. Programmable Search Engine – Anfrageformat <ph type="x-smartling-placeholder">
      </ph>
    1. Anfrageübersicht
    2. Suchbegriffe
    3. Anfrageparameter <ph type="x-smartling-placeholder">
        </ph>
      1. Beispiele für WebSearch-Suchanfragen
      2. Definitionen der WebSearch-Suchparameter
      3. Erweiterte Suche
      4. Parameter für erweiterte Suchanfragen
      5. Besondere Suchbegriffe
      6. Beispielabfragen für Bilder
      7. Suchparameter für die Bildersuche
      8. Anfragelimits
    4. Präsentation: Abfragen und Ergebnisse internationalisieren <ph type="x-smartling-placeholder">
        </ph>
      1. Zeichencodierung
      2. Sprachen der Benutzeroberfläche
      3. Suche (vereinfacht und traditionell)
    5. Ergebnisse filtern <ph type="x-smartling-placeholder">
        </ph>
      1. Automatisches Filtern von Suchergebnissen
      2. Nach Sprache und Land filtern
      3. Inhalte nur für Erwachsene mit SafeSearch herausfiltern
  3. XML-Ergebnisse <ph type="x-smartling-placeholder">
      </ph>
    1. Google XML-Ergebnis-DTD
    2. Informationen zur XML-Antwort
    3. XML-Ergebnisse für Regular, Image und Erweiterte Suchanfragen <ph type="x-smartling-placeholder">
        </ph>
      1. Reguläre/erweiterte Suche: Beispielabfrage und XML-Ergebnis
      2. Reguläre/erweiterte Suche: XML-Tags
      3. XML-Ergebnisse für Bildersuchen
      4. Bildersuche: Beispielabfrage und XML-Ergebnis
      5. Bildersuche: XML-Tags

Übersicht

Der Dienst Google WebSearch ermöglicht die Google Website-Suche. Kunden die Möglichkeit, Google-Suchergebnisse auf ihren eigenen Websites anzuzeigen. Die Der WebSearch-Dienst verwendet für die Suche ein einfaches HTTP-basiertes Protokoll. Ergebnisse. Suchadministratoren haben die vollständige Kontrolle darüber, Suchergebnisse und die Art und Weise, wie diese Endanwendenden. In diesem Dokument werden die technischen Details des und Ergebnisformaten.

Zum Abrufen von Google WebSearch-Ergebnissen sendet Ihre Anwendung eine einfache HTTP-Anfrage an Google senden. Google gibt die Suchergebnisse dann in XML zurück. Format. Bei XML-formatierten Ergebnissen können Sie die Art und Weise, wie Suchergebnisse angezeigt werden.

Format der WebSearch-Anfrage

Anfragen – Übersicht

Die Google-Suchanfrage ist ein Standard-HTTP-Befehl GET. Es enthält eine Sammlung von Parametern, die für Ihre Abfragen. Diese Parameter sind in der Anfrage-URL als name=value enthalten. -Paare, die durch kaufmännische Und-Zeichen (&) getrennt sind. Zu den Parametern gehören wie die Suchanfrage und eine eindeutige Suchmaschinen-ID (cx), die den die die HTTP-Anfrage stellt. Der WebSearch- oder Bildersuche-Dienst gibt XML als Antwort auf Ihre HTTP-Anfragen.

Suchbegriffe

Die meisten Suchanfragen enthalten einen oder mehrere Suchbegriffe. Einen Suchbegriff als Wert eines Parameters in der Suchanfrage erscheint.

Suchbegriffe können verschiedene Arten von Informationen angeben, die gefiltert und die von Google zurückgegebenen Suchergebnisse zu organisieren. In Abfragen kann Folgendes angegeben werden:

  • Wörter oder Wortgruppen, die enthalten oder ausschließen <ph type="x-smartling-placeholder">
      </ph>
    • Alle Wörter in einer Suchanfrage (Standardeinstellung)
    • Eine genaue Wortgruppe in der Suchanfrage
    • Jedes Wort oder jede Wortgruppe in einer Suchanfrage
  • Wo in einem Dokument nach dem Suchbegriffe <ph type="x-smartling-placeholder">
      </ph>
    • An einer beliebigen Stelle im Dokument (Standard)
    • Nur im Text des Dokuments
    • Nur im Dokumenttitel
    • Nur in der Dokument-URL
    • Nur in Links im Dokument
  • Einschränkungen bezüglich der Dokumente selbst <ph type="x-smartling-placeholder">
      </ph>
    • Ein- oder Ausschließen von Dokumenten bestimmter Dateitypen (z. B. PDF- oder Word-Dokumente)
  • Spezielle URL-Abfragen, die Folgendes zurückgeben Informationen über eine bestimmte URL zu erhalten, statt eine Suche durchzuführen <ph type="x-smartling-placeholder">
      </ph>
    • Abfragen, die allgemeine Informationen zu einer URL zurückgeben, z. B. Open Directory-Kategorie, -Snippet oder -Sprache
    • Suchanfragen, die die Webseiten zurückgeben, die auf eine URL verweisen
    • Suchanfragen, die eine Reihe von Webseiten zurückgeben, die einer bestimmten URL ähneln

Standardsuche

Werte von Suchparametern müssen URL-codiert sein. Beachten Sie, dass Sie würde das Pluszeichen („+“) für alle Leerzeichen in der Suchanfrage. Dies wird im Abschnitt URL-Escaping dieses Dokuments näher erläutert.

Der Suchbegriff wird mithilfe von Parameter q A Beispiel für eine Suchanfrage:

q=horses+cows+pigs

Standardmäßig gibt der Google WebSearch-Dienst nur Dokumente zurück, die alle Begriffe in die Suchanfrage aufnehmen.

Anfrageparameter

In diesem Abschnitt werden die Parameter aufgeführt, die Sie beim Erstellen eines Suchanfrage. Die Parameter sind in zwei Listen unterteilt. Die erste Liste enthält Parameter, die für alle Suchanfragen relevant sind. Die zweite Liste enthält Parameter, die sind die nur für erweiterte Suchanfragen relevant sind.

Es sind drei Anfrageparameter erforderlich:

  • Der Parameter client muss auf google-csbe festgelegt sein.
  • Der output-Parameter gibt den Format der zurückgegebenen XML-Ergebnisse; Ergebnisse können mit (xml) zurückgegeben werden. oder ohne (xml_no_dtd) einen Verweis auf die DTD von Google. Wir empfehlen, indem Sie diesen Wert auf xml_no_dtd setzen. Hinweis:Wenn Sie diesen Parameter nicht angeben, werden Ergebnisse in HTML anstelle von XML.
  • Der Parameter cx für den eindeutigen Wert ID der Suchmaschine.

Abgesehen von den am häufigsten verwendeten Anfrageparametern oben genannten sind:

  • num: die angeforderte Anzahl von Suchergebnissen
  • q: die Suchbegriffe
  • start: der Startindex für die Ergebnisse

Beispiele für WebSearch-Anfragen

Die Beispiele unten zeigen einige WebSearch-HTTP-Anfragen an wie unterschiedliche Suchparameter verwendet werden. Definitionen der werden in der WebSearch-Abfrage Parameterdefinitionen und die erweiterte Suchanfrage Parameter dieses Dokuments.

Bei dieser Anfrage werden die ersten zehn Ergebnisse ausgegeben (start=0&num=10) für den Suchbegriff „red sox“ (q=red+sox) Die Abfrage gibt an, dass die Ergebnisse von kanadischen Websites (cr=countryCA) stammen sollen und sollten auf Französisch (lr=lang_fr) verfasst sein. Die Abfrage gibt Werte für client, output, und cx-Parameter, die alle 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 wird ein Teil der Suchanfrage Parameter, um die Suchanfrage weiter anzupassen. Diese Anfrage verwendet den as_q (as_q=red+sox) anstelle des Parameters q. Außerdem werden die Parameter as_eq, um alle Dokumente auszuschließen, die das Wort „Yankees“ enthalten aus der Suchergebnisse (as_eq=yankees).

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 Methode Vereinfachte und der Suche in traditionellem Chinesisch.

Der Standardwert für diesen Parameter ist 0 (null). Das bedeutet, ob die Funktion aktiviert ist. Für den Parameter c2coff sind folgende Werte verfügbar:

Wert Aktion
1 Deaktiviert
0 Aktiviert
Beispiele q=google&c2coff=1

Client
Beschreibung

Erforderlich. Der Parameter client muss auf google-csbe festgelegt sein.

Beispiele q=google&client=google-csbe

cr
Beschreibung

Optional: Der Parameter cr beschränkt die Suchergebnisse auf Dokumente, die aus einem dieser in einem bestimmten Land. Sie können Boolesche Variable Operatoren im Parameter cr Wert.

Google WebSearch ermittelt das Land eines Dokuments durch Analyse:

  • Die Top-Level-Domain (TLD) der Dokument-URL
  • Der geografische Standort der IP-Adresse des Webservers

Siehe den Parameter für das Land (cr) Werte eine Liste gültiger Werte für diesen Parameter.

Beispiele q=Frodo&cr=countryNZ

cx
Beschreibung

Erforderlich. Der Parameter cx gibt eine eindeutige der eine benutzerdefinierte Suchmaschine. Sie müssen eine Programmable Search Engine mithilfe des Parameters cx angeben, um Suchergebnisse aus dieser Engine abzurufen.

Den Wert des cx-Parameters finden Sie unter „Systemsteuerung“ > Codes Ihrer Suchmaschine finden Sie im Textbereich unter "Diesen Code auf der Seite einfügen, auf der das Suchfeld erscheinen. Die Suchergebnisse werden auf einer von Google gehosteten Seite angezeigt.“

Beispiele q=Frodo&cx=00255077836266642015:u-scht7a-8i

Filter
Beschreibung

Optional: Der Parameter filter aktiviert oder deaktiviert das automatische Filtern von Google-Suchergebnissen. Weitere Informationen finden Sie im Abschnitt Automatische Filterung in dieser Dokument finden Sie weitere Informationen zu den Suchergebnisfiltern von Google.

Der Standardwert für den Parameter filter ist 1. was bedeutet, dass die Funktion aktiviert ist. Gültige Werte dafür Parameter:

Wert Aktion
1 Deaktiviert
0 Aktiviert

Hinweis:Standardmäßig filtert Google alle um die Qualität zu verbessern.

Beispiele q=google&filter=0

gl
Beschreibung

Optional: Der Parameterwert gl ist ein Ländercode aus zwei Buchstaben. Bei WebSearch-Ergebnissen werden mit dem Parameter gl Suchergebnisse erhöht, deren Ursprungsland mit dem Parameterwert eingeben. Im Abschnitt Ländercodes finden Sie eine Liste der gültigen Werte.

gl-Parameterwert in WebSearch-Anfragen angeben die Relevanz der Ergebnisse verbessern. Dies gilt insbesondere für für internationale Kunden und insbesondere für Kunden in englischsprachigen Ländern außer den USA

Beispiele

Dieses Ersuchen erhöht die Anzahl der im Vereinigten Königreich verfassten Dokumente WebSearch-Ergebnisse:
q=pizza&gl=uk


hl
Beschreibung

Optional: Der Parameter hl gibt die Sprache der Benutzeroberfläche (Hostsprache) Ihrer Benutzeroberfläche. Zur Verbesserung die Leistung und die Qualität der Suchergebnisse, wird dringend empfohlen, diesen Parameter explizit festzulegen.

Weitere Informationen finden Sie im Abschnitt Sprachen der Benutzeroberfläche des Artikels Abfragen internationalisieren. und der Ergebnispräsentation finden Sie weitere Informationen sowie die unterstützten Oberflächensprachen. finden Sie eine Liste der unterstützten Sprachen.

Beispiele

Diese Anfrage ist auf Anzeigen für Wein auf Französisch 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 hq werden die angegebenen Suchbegriffe an Abfrage hinzu, als wären sie mit einem logischen AND-Operator kombiniert.

Beispiele

Diese Anfrage sucht nach „Pizza“. UND "Käse". Der Ausdruck ist mit q=pizza+cheese identisch.

q=pizza&hq=cheese


ie
Beschreibung

Optional: Der Parameter ie legt das Zeichen Codierungsschema, das zur Interpretation der Abfragezeichenfolge verwendet werden sollte. Die Der Standardwert von ie ist latin1.

Im Abschnitt Zeichencodierung wird beschrieben, wann Sie diesen Parameter möglicherweise verwenden müssen.

Weitere Informationen finden Sie im Abschnitt zur Zeichencodierung Schemas für die Liste der möglichen ie-Werte.

Beispiele q=google&ie=utf8&oe=utf8
lr
Beschreibung

Optional: Der Parameter lr (Sprachbeschränkung) beschränkt die Suchergebnisse auf Dokumente. in einer bestimmten Sprache verfasst ist.

Google WebSearch ermittelt die Sprache eines Dokuments, indem Analyse:

  • Die Top-Level-Domain (TLD) der Dokument-URL
  • Sprach-Meta-Tags innerhalb des Dokuments
  • die im Haupttext des Dokuments verwendete primäre Sprache
  • Im Text des Dokuments verwendete Sekundärsprachen, falls vorhanden

Siehe Sprache (lr) Im Abschnitt „Collection Values“ (Sammlungswerte) finden Sie eine Liste gültiger Werte dafür. .

Beispiele q=Frodo&lr=lang_en

Zahl
Beschreibung

Optional: Der num-Parameter gibt die Anzahl der Suchergebnisse, die zurückgegeben werden sollen.

Der Standardwert für num ist 10 und der Maximalwert Wert ist 20. Wenn Sie mehr als 20 Ergebnisse anfordern, werden nur 20 Ergebnisse zurückgegeben.

Hinweis:Wenn die Gesamtzahl der Suchergebnisse kleiner ist, als die angeforderte Anzahl von Ergebnissen, werden alle verfügbaren Suchergebnisse zurückgegeben werden kann.

Beispiele q=google&num=10

oe
Beschreibung

Optional: Der Parameter oe legt das Zeichen Codierungsschema, das zur Decodierung des XML-Ergebnisses verwendet werden soll. Die Der Standardwert von oe ist latin1.

Im Abschnitt Zeichencodierung wird beschrieben, wann Sie diesen Parameter möglicherweise verwenden müssen.

Weitere Informationen finden Sie im Abschnitt zur Zeichencodierung Schemas für die Liste der möglichen oe-Werte.

Beispiele q=google&ie=utf8&oe=utf8

output
Beschreibung

Erforderlich. Der Parameter output gibt das Format der XML-Ergebnisse an. Die einzige gültige Die Werte für diesen Parameter sind xml und xml_no_dtd. Die unten wird erläutert, wie sich diese Parameterwerte unterscheiden.

Wert Ausgabeformat
xml_no_dtd Die XML-Ergebnisse enthalten kein !DOCTYPE-Anweisung. (Empfohlen)
xml Die XML-Ergebnisse enthalten ein DTD-Referenz. In der zweiten Zeile des Ergebnisses wird das Dokument angegeben. Definitionstyp (DTD), der in den Ergebnissen verwendet wird:
    <!DOCTYPE GSP SYSTEM "google.dtd">
Beispiele output=xml_no_dtd
output=xml

q
Beschreibung

Optional: Der Parameter q gibt die Suchanfrage an. Suchanfrage, die der Nutzer eingegeben hat. Auch wenn dieser Parameter optional ist, muss einen Wert für mindestens einen der Suchparameter angeben (as_epq, as_lq, as_oq, as_q um Suchergebnisse zu erhalten.

Es gibt auch eine Reihe von speziellen Suchbegriffen, die wird als Teil des Parameters q verwendet. Wert. Eine Liste und Definitionen dieser Begriffe finden Sie unter Besondere Suchbegriffe.

Das Steuerfeld der Google Suche enthält einen Bericht Abfragen, die mit dem Parameter q gesendet wurden.

Hinweis:Der für den Parameter q angegebene Wert muss mit URL-Escape-Zeichen angegeben werden.

Beispiele q=vacation&as_oq=london+paris

sicher
Beschreibung

Optional: Der Parameter safe gibt an, wie Suchergebnisse nach Erwachsenen- und pornografische Inhalte. Der Standardwert für den Parameter safe ist off. Gültige Parameterwerte sind:

Wert Aktion
off SafeSearch deaktivieren
medium SafeSearch aktivieren
high Eine striktere Version von SafeSearch aktivieren

Weitere Informationen hierzu erhalten Sie im Artikel Filtern von Inhalten nur für Erwachsene mit SafeSearch.

Beispiele q=adult&safe=high

start
Beschreibung

Optional: Der Parameter start gibt das erste übereinstimmende Ergebnis an, das einbezogen werden soll. in den Suchergebnissen. Der Parameter start verwendet einen nullbasierten Index, d. h. das erste Ergebnis ist 0, der das zweite Ergebnis 1 ist usw.

Der Parameter start funktioniert in in Verbindung mit dem Parameter num, um festzulegen, welche Suchergebnisse zurückgegeben werden sollen. Beachten Sie, dass für eine Abfrage nicht mehr als 1.000 Ergebnisse zurückgegeben werden, auch wenn mehr als 1.000 Dokumente mit der Abfrage übereinstimmen. Daher führt das Festlegen von „Start“ auf 1.000 oder mehr zu keinen Ergebnissen.

Beispiele start=10

Sortieren
Beschreibung

Optional: Der Parameter sort gibt an, dass die Ergebnisse nach dem angegebenen Ausdruck sortiert werden. Sie können zum Beispiel nach Datum sortieren.

Beispiele

sort=date


Ud
Beschreibung

Optional: Der Parameter ud gibt an, Legt fest, ob die XML-Antwort die IDN-codierte URL für das Suchergebnis enthalten soll. Die IDN-Codierung (International Domain Name) ermöglicht das Anzeigen von Domains mit lokaler Sprachen, zum Beispiel:

http://www.花井鮨.com

Gültige Werte für diesen Parameter sind 1 (Standard). Das XML-Ergebnis sollte also IDN-codierte URLs enthalten und 0, d. h. das XML-Ergebnis sollte keine IDN-codierten URLs enthalten. URLs. Wenn der Parameter ud auf 1 gesetzt ist, erscheint die IDN-codierte URL in im UD-Tag in Ihren XML-Ergebnissen.

Wenn der Parameter ud auf 0 gesetzt ist, lautet die URL im Beispiel oben angezeigt als:

http://www.xn--elq438j.com.

Hinweis:Dies ist eine Betafunktion.

Beispiele q=google&ud=1

Die zusätzlichen Suchparameter, die unter dem Bild aufgeführt sind, sind für erweiterte Suchanfragen relevant. Wenn Sie eine erweiterte Suche ausführen, werden die Werte mehrerer Parameter (z.B. as_eq, as_epq, as_oq usw.) Begriffe für diese Suche. Das Bild zeigt die Seite „Erweiterte Suche“ von Google. Auf dem Bild sind die Namen der Parameter für die erweiterte Suche in rotem Text im oder neben dem das Feld auf der Seite, dem der Parameter entspricht.



Parameter für erweiterte Suchanfragen

as_dt
Beschreibung

Optional: Mit dem Parameter as_dt wird gesteuert, , um Ergebnisse der im as_sitesearch-Parameter angegebenen Website ein- oder auszuschließen. Die die Werte i und e einen Einschluss bzw. Ausschluss an.

Beispiele as_dt=i,as_dt=e

as_epq
Beschreibung

Optional: Der Parameter as_epq identifiziert ein Wortgruppe, die alle Dokumente in den Suchergebnissen enthalten müssen. Sie können verwenden Sie auch den Suchbegriff Wortgruppe, um nach einer Wortgruppe suchen.

Beispiele as_epq=abraham+lincoln

as_eq
Beschreibung

Optional: Der Parameter as_eq identifiziert ein Wort oder Wortgruppe, die in keinem der Dokumente der Suche erscheinen soll Ergebnisse. Sie können auch die Abfrage exclude um sicherzustellen, dass ein bestimmtes Wort oder eine bestimmte Wortgruppe nicht im in einer Reihe von Suchergebnissen.

Beispiele

q=bass&as_eq=music.


as_lq
Beschreibung

Optional: Der Parameter as_lq gibt an, dass sollten alle Suchergebnisse einen Link zu einer bestimmten URL enthalten. Sie können auch verwenden Sie für diese Art von Suchanfrage den Suchbegriff link:.

Beispiele

as_lq=www.google.com


as_nlo
Beschreibung

Optional: Der Parameter as_nlo gibt den Startwert für Suchbereich. Verwenden Sie as_nlo und as_nhi, um eine einschließende Suche anzufügen as_nlo...as_nhi-Bereich der Abfrage hinzufügen.

Beispiele

Im Folgenden wird ein Suchbereich von 5 bis einschließlich 10 festgelegt:

as_nlo=5&as_nhi=10

as_nhi
Beschreibung

Optional: Der Parameter as_nhi gibt die Endwert für einen Suchbereich. Verwenden Sie as_nlo und as_nhi, um ein eingeschlossenen Suchbereich von as_nlo...as_nhi für die Abfrage.

Beispiele

Im Folgenden wird ein Suchbereich von 5 bis einschließlich 10 festgelegt:

as_nlo=5&as_nhi=10

as_oq
Beschreibung

Optional: Der Parameter as_oq liefert zusätzliche Suchbegriffe, nach denen in einem Dokument gesucht werden soll, wobei jedes Dokument muss in den Suchergebnissen mindestens eine der zusätzlichen . Sie können auch den Booleschen OR-Abfragebegriff für diese Art von Abfrage.

Beispiele

q=vacation&as_oq=London+Paris


as_q
Beschreibung

Optional: Über den Parameter as_q können Sie nach welchen Begriffen in einem Dokument gesucht werden soll. Dieser Parameter wird auch häufig verwendet, Damit Nutzer zusätzliche Begriffe für die Suche innerhalb einer Gruppe angeben können von Suchergebnissen.

Beispiele

q=president&as_q=John+Adams


as_qdr
Beschreibung

Optional: Der Parameter as_qdr fordert eine Suche an Ergebnisse aus einem bestimmten Zeitraum (schneller Zeitraum). Folgende Werte werden unterstützt:

d[number] fordert Ergebnisse der angegebenen Anzahl von vergangenen Tagen an.
w[number] fordert Ergebnisse aus der angegebenen Anzahl der vergangenen Wochen an.
m[number] fordert Ergebnisse aus der angegebenen Anzahl der vergangenen Monate an.
y[number] fordert Ergebnisse aus der angegebenen Anzahl von vergangenen Jahren an.

Beispiele

In diesem Beispiel werden Ergebnisse aus dem letzten Jahr angefordert:

as_qdr=y

In diesem Beispiel werden Ergebnisse der letzten 10 Tage angefordert:

as_qdr=d10

as_sitesearch
Beschreibung

Optional: Mit dem Parameter as_sitesearch können Sie angeben, dass alle Suchergebnisse Seiten einer bestimmten Website sein sollen. Wenn du den Parameter as_dt festlegst, kannst du damit auch Seiten einer bestimmten Website aus deinen Suchergebnissen ausschließen.

Beispiele

q=vacation&as_sitesearch=www.google.com


Besondere Abfragebegriffe

Bei Google WebSearch können mehrere spezielle Suchbegriffe verwendet werden, Zugriff auf zusätzliche Funktionen der Google-Suchmaschine. Diese sollten im Wert des Anfrageparameters q spezielle Suchbegriffe enthalten sein. Wie bei anderen Suchbegriffen Spezielle Suchbegriffe müssen mit URL-Escaping versehen sein. A die Anzahl der speziellen Suchbegriffe einen Doppelpunkt (:) enthält. Dieses Zeichen muss ebenfalls URL-codiert sein. der Wert mit URL-Escaping ist %3A.

Backlinks [link:]
Beschreibung

Der Suchbegriff link: ruft die Gruppe von Webseiten ab. die auf eine bestimmte URL verweisen. Die Suchanfrage muss das Format link:URL ohne Leerzeichen zwischen dem link:-Suchbegriff und der URL haben.

Die URL-Escaping-Version von link: ist link%3A.

Sie können auch die as_lq-Anfrage verwenden. Parameter zum Senden einer link:-Anfrage.

Hinweis:Sie können keine anderen Suchbegriffe angeben, wenn mit link:.

Beispiele

http://www.google.com/search?q=link%3Awww.example.com


Boolescher OR-Suchvorgang [ ODER ]
Beschreibung

Mit dem Abfragebegriff OR werden Dokumente abgerufen, die eines enthalten. aus einer Reihe von (zwei oder mehr) Suchbegriffen. OR-Abfrage verwenden würden Sie den Suchbegriff OR in Großbuchstaben einfügen. Buchstaben zwischen den einzelnen Begriffen in der Reihe.

Sie können auch die as_oq-Anfrage verwenden. , um eine Suche nach einem beliebigen Begriff in einer Gruppe von Begriffen zu senden.

Hinweis:Wenn eine Suchanfrage die Suchanfrage "London+OR+Paris" angibt, enthalten die Suchergebnisse Dokumente, die mindestens eines dieser beiden Wörter enthalten. In einigen Fällen Dokumente in den Suchergebnissen können beide Wörter enthalten.

Beispiele

Suche nach London oder Paris:

Nutzereingabe:london OR paris Suchbegriff:q=london+OR+paris

Suchen Sie nach „Urlaub“ und entweder nach London oder Paris:

Suchbegriff:q=vacation+london+OR+paris

Suchen Sie nach Urlaub und nach London, Paris oder Schokolade:

Suchbegriff:  q=vacation+london+OR+paris+OR+chocolates

Suchen Sie nach "Urlaub" und "Pralinen" und entweder nach London oder Paris. wobei das geringste Gewicht für Pralinen gilt:

Suchbegriff:  q=vacation+london+OR+paris+chocolates

Suchen Sie in Dokumenten nach Urlaub, Pralinen und Blumen, auch London oder Paris enthalten:

Suchbegriff:  q=vacation+london+OR+paris+chocolates+flowers

Suchen Sie nach Urlaub und von London oder Paris und suchen Sie auch für Pralinen oder Blumen:

Suchbegriff:  q=vacation+london+OR+paris+chocolates+OR+flowers

Suchbegriff ausschließen [-]
Beschreibung

Der auszuschließende Suchbegriff (-) schränkt die Ergebnisse für ein an Dokumente gesendet werden, die kein für ein bestimmtes Wort oder eine bestimmte Wortgruppe. Um den auszuschließenden Suchbegriff zu verwenden, dem Wort oder der Wortgruppe, die aus den übereinstimmenden Dokumenten ausgeschlossen werden sollen, voranstellen mit „-“ (Minuszeichen).

Die URL-Escaping-Version von - ist %2D.

Der auszuschließende Suchbegriff ist nützlich, wenn ein Suchbegriff mehr als eine Bedeutung. Zum Beispiel ist das Wort „Bass“ könnte Ergebnisse zurückgeben entweder über Fisch oder Musik. Wenn Sie nach Dokumenten über Fische, könnten Sie Dokumente über Musik aus Ihren Suchergebnissen ausschließen. indem Sie den auszuschließenden Suchbegriff verwenden.

Sie können auch die as_eq-Anfrage verwenden. Parameter zum Ausschließen von Dokumenten, die mit einem bestimmten Wort oder einer bestimmten Wortgruppe übereinstimmen aus den Suchergebnissen entfernt.

Beispiele Nutzereingabe: bass -music
Suchbegriff: q=bass+%2Dmusic

Ausschließen von Dateityp [ -Dateityp: ]
Beschreibung

Der Suchbegriff -filetype: schließt Dokumente mit einem bestimmte Dateiendung, z. B. „.pdf“ oder ".doc" aus Suche Ergebnisse. Die Suchanfrage muss als -filetype:EXTENSION ohne Leerzeichen zwischen dem -filetype:-Suchbegriff und dem die angegebene Erweiterung hat.

Die URL-Escaping-Version von -filetype: ist %2Dfiletype%3A.

Hinweis:Sie können mehrere Dateitypen aus Suchergebnissen entfernen, indem du weitere -filetype:-Suchanfragen hinzufügst Begriffe hinzufügen. Sie sollten einen -filetype:-Suchbegriff haben für jede Dateierweiterung, die ausgeschlossen werden soll. aus den Suchergebnissen entfernt.

Google unterstützt unter anderem folgende Dateitypen:

  • Adobe Portable Document Format (PDF)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (Wo.1, WK2, WK3, WK4, WK5, WK, WK, WK)
  • Lotus WordPro (LWP)
  • Mac-Write (MW)
  • Microsoft Excel (XLS)
  • Microsoft PowerPoint (PPT)
  • Microsoft Word (Dokument)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (Wri)
  • Rich-Text-Format (RTF)
  • Shockwave Flash (SWF)
  • Text (ans, txt):

In Zukunft werden möglicherweise weitere Dateitypen hinzugefügt. Eine aktuelle finden Sie jederzeit in den häufig gestellten Fragen zu Dateitypen von Google.

Beispiele

In diesem Beispiel werden Dokumente zurückgegeben, in denen „Google“ erwähnt wird. aber das sind keine PDF-Dokumente:
q=Google+%2Dfiletype%3Apdf

In diesem Beispiel werden Dokumente zurückgegeben, in denen „Google“ erwähnt wird. aber PDF- und Word-Dokumente sind ausgeschlossen:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc


Filtern nach Dateityp [ filetype: ]
Beschreibung

Der Suchbegriff filetype: beschränkt die Suchergebnisse auf Dokumente mit einer bestimmten Dateiendung, z. B. „.pdf“, oder ".doc". Die Suchanfrage muss das Format filetype:EXTENSION mit kein Leerzeichen zwischen dem filetype:-Suchbegriff und dem angegebenen .

Die URL-Escaping-Version von filetype: ist filetype%3A.

Du kannst die Suche einschränken Ergebnisse zu Dokumenten, die mit einer von mehreren Dateiendungen übereinstimmen, indem Sie weitere filetype: Suchbegriffe zu deiner Suchanfrage hinzufügen. Ihre Suchanfrage sollte für jede Dateiendung, die in den Suchergebnissen enthalten sein soll, einen filetype:-Suchbegriff enthalten. Mehrere filetype:-Suchbegriffe müssen durch den OR-Suchbegriff getrennt werden.

Standardmäßig erscheinen die Suchergebnisse Dokumente mit beliebiger Dateiendung einfügen.

Google unterstützt unter anderem folgende Dateitypen:

  • Adobe Portable Document Format (PDF)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (Wo.1, WK2, WK3, WK4, WK5, WK, WK, WK)
  • Lotus WordPro (LWP)
  • Mac-Write (MW)
  • Microsoft Excel (XLS)
  • Microsoft PowerPoint (PPT)
  • Microsoft Word (Dokument)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (Wri)
  • Rich-Text-Format (RTF)
  • Shockwave Flash (SWF)
  • Text (ans, txt):

In Zukunft werden möglicherweise weitere Dateitypen hinzugefügt. Eine aktuelle finden Sie jederzeit in den häufig gestellten Fragen zu Dateitypen von Google.

Beispiele

In diesem Beispiel werden PDF-Dokumente zurückgegeben, in denen „Google“ erwähnt wird:
q=Google+filetype%3Apdf

In diesem Beispiel werden PDF- und Word-Dokumente zurückgegeben, in denen „Google“:
q=Google+filetype%3Apdf+OR+filetype%3Adoc


Suchbegriff einschließen [+]
Beschreibung

Der Suchbegriff einschließen (+) gibt an, dass ein Wort oder eine Wortgruppe muss in allen Dokumenten vorkommen, die in den Suchergebnissen enthalten sind. So verwenden Sie die Suchbegriff enthält, stellen Sie dem Wort oder der Wortgruppe, mit "+" in alle Suchergebnisse aufgenommen (Pluszeichen).

Die URL-Escaping-Version von + (ein Pluszeichen) ist %2B.

Sie sollten + vor einem allgemeinen Wort verwenden, das von Google werden normalerweise verworfen, bevor Suchergebnisse identifiziert werden.

Beispiele Nutzereingabe: Star Wars Episode +I
Suchbegriff: q=Star+Wars+Episode+%2BI

Nur Links, Suche, alle Begriffe [ allinlinks: ]
Beschreibung

Für den Suchbegriff allinlinks: sind Dokumente im folgenden Format erforderlich: Suchergebnisse, die alle Wörter der Suchanfrage in der URL enthalten. Links. Die Suchanfrage muss als allinlinks: formatiert sein, gefolgt von den Wörtern in der Suchanfrage.

Wenn Ihre Suchanfrage die Anfrage allinlinks: enthält überprüft Google nur die URL-Links in Dokumenten auf die Wörter in Ihrer Suchanfrage, wobei der Text in den Dokumenten ignoriert wird, Dokumenttitel und die URLs der einzelnen Dokumente. Beachten Sie, dass das Dokument Die URL unterscheidet sich von den URL-Links im Dokument.

Die URL-Escaping-Version von allinlinks: ist allinlinks%3A.

Beispiele Nutzereingabe:allinlinks: Google search
Suchbegriff:q=allinlinks%3A+Google+search

Wortgruppensuche
Beschreibung

Mit dem Suchbegriff für Wortgruppensuche ( ) kannst du nach folgenden Begriffen suchen: Sätze vervollständigen, indem Sie sie in Anführungszeichen setzen oder und sie mit Bindestrichen verbunden.

Die URL-Escaping-Version von " (ein Anführungszeichen) ist %22.

Wortgruppensuchen sind besonders nützlich, nach bekannten Zitaten oder Eigennamen suchen.

Sie können auch die Anfrage as_epq verwenden. um eine Wortgruppe zu senden.

Beispiele Nutzereingabe:"Abraham Lincoln"
Suchbegriff: q=%22Abraham+Lincoln%22

Nur Textsuche, alle Begriffe [allintext:]
Beschreibung

Der Abfragebegriff allintext: erfordert jedes Dokument in in den Suchergebnissen so, dass sie alle Wörter der Suchanfrage in den Textkörper des Dokuments. Die Suchanfrage muss als allintext: formatiert sein, gefolgt von den Wörtern in der Suchanfrage.

Wenn Ihre Suchanfrage die Anfrage allintext: enthält überprüft Google nur den Textkörper von Dokumenten auf die Wörter in Ihrer Suchanfrage, indem Sie Links in diesen Dokumenten ignorieren, und Dokument-URLs.

Die URL-Escaping-Version von allintext: ist allintext%3A.

Beispiele In diesem Beispiel werden die Wörter „Google“ und „suchen“ muss im Text aller enthaltenen Dokumente erscheinen in den Suchergebnissen:
Nutzereingabe:allintext:Google search
Suchbegriff:q=allintext%3AGoogle+search

Titelsuche, einzelner Begriff [intitle:]
Beschreibung

Der Suchbegriff intitle: beschränkt die Suchergebnisse auf Dokumente, die ein bestimmtes Wort im Dokumenttitel enthalten. Die Die Suchanfrage muss das Format intitle:WORD ohne Leerzeichen haben. zwischen dem intitle:-Suchbegriff und dem folgenden Wort setzen.

Hinweis:Sie können weitere als ein Wort, das im Dokumenttitel enthalten sein muss, indem Sie den intitle:-Suchbegriff vor jedem Wort. Sie können Sie können auch den Suchbegriff allintitle: verwenden, um angeben, dass alle Wörter der Suchanfrage im Titel der die in den Suchergebnissen enthalten sind.

Die URL-Escaping-Version von intitle: ist intitle%3A.

Beispiele

In diesem Beispiel wird das Wort „Google“ muss in die Titel aller Dokumente in den Suchergebnissen und das Wort „suchen“ müssen an einer beliebigen Stelle in den Titeln, URLs, Links oder Textkörpern vorkommen. dieser Dokumente:
Nutzereingabe:intitle:Google search
Suchbegriff:q=intitle%3AGoogle+search


Titelsuche, alle Begriffe [allintitle:]
Beschreibung

Der Suchbegriff allintitle: beschränkt die Suchergebnisse auf Dokumente, die alle Wörter der Suchanfrage im Dokumenttitel enthalten. Bis den allintitle:-Suchbegriff verwenden, einschließlich „allintitle:“ im Anfang Ihrer Suchanfrage.

Hinweis:Wenn Sie allintitle: am Anfang einer Suchanfrage einfügen, erzielen Sie dasselbe Ergebnis wie mit intitle: vor jedem Wort in der Suche. Abfrage.

Die URL-Escaping-Version von allintitle: lautet allintitle%3A.

Beispiele

In diesem Beispiel werden die Wörter „Google“ und „suchen“ muss in den Titeln aller Dokumente in den Suchergebnissen vorkommen:
Nutzereingabe:allintitle: Google search
Suchbegriff: q=allintitle%3A+Google+search


URL-Suche, einzelner Begriff [inurl:]
Beschreibung

Der Suchbegriff inurl: beschränkt die Suchergebnisse auf Dokumente, die ein bestimmtes Wort in der Dokument-URL enthalten. Die Die Suchanfrage muss das Format inurl:WORD ohne Leerzeichen haben. zwischen dem inurl:-Suchbegriff und dem folgenden Wort setzen.

Die inurl:-Abfrage Begriff ignoriert Satzzeichen und verwendet nur das erste Wort nach dem inurl:-Operator. Sie können mehrere Wörter angeben, die in der Dokument-URL, indem Sie den inurl:-Suchbegriff vor jedes Wort dieser Art. Sie können auch den Suchbegriff allinurl: verwenden, um anzugeben, dass alle Wörter der Suchanfrage in den URLs enthalten sein müssen. von Dokumenten in den Suchergebnissen.

Die URL-Escaping-Version von inurl: ist inurl%3A.

Beispiele

In diesem Beispiel wird das Wort „Google“ muss in die URLs aller Dokumente in den Suchergebnissen und das Wort „suche“ müssen irgendwo in den Titeln, URLs, Links oder Texten dieser URLs erscheinen. Dokumente:
Nutzereingabe: inurl:Google search
Suchbegriff: q=inurl%3AGoogle+search


URL-Suche, alle Begriffe [allinurl:]
Beschreibung

Der Suchbegriff allinurl: beschränkt die Suchergebnisse auf Dokumente, die alle Wörter der Suchanfrage in der Dokument-URL enthalten. Bis allinurl:-Suchbegriff verwenden, am Anfang allinurl: einfügen Ihrer Suchanfrage.

Der Suchbegriff allinurl: ignoriert Satzzeichen und funktioniert daher nur bei Wörtern, nicht bei URLs Komponenten. Beispielsweise schränkt allinurl: uk/scotland die Ergebnisse ein bis zu Dokumenten, die die Wörter „uk“ enthalten und "Schottland" in ihren URLs verwenden, aber nicht verlangen, dass diese beiden Wörter in einem bestimmten oder durch einen Schrägstrich getrennt sein.

Die URL-Escaping-Version von allinurl: ist allinurl%3A.

Beispiele

In diesem Beispiel werden die Wörter „Google“ und „suchen“ muss in den URLs aller Dokumente in den Suchergebnissen erscheinen:
Nutzereingabe: allinurl: Google search
Suchbegriff: q=allinurl%3A+Google+search



Webdokumentinformationen [info:]
Beschreibung

Mit dem Abfragebegriff info: werden allgemeine Informationen abgerufen. solange diese URL im Suchindex von Google enthalten ist. Die Suchanfrage muss das Format info:URL ohne Leerzeichen haben. zwischen dem info:-Suchbegriff und der URL.

Die URL-Escaping-Version von info: ist info%3A.

Hinweis:Sie können keine anderen Suchbegriffe angeben, wenn mit info:.

Beispiele Nutzereingabe: info:www.google.com
Suchbegriff: q=info%3Awww.google.com

Beispielanfragen für Bilder

Die folgenden Beispiele zeigen einige Bild-HTTP-Anfragen, um die Verwendung verschiedener Suchparameter zu veranschaulichen. Definitionen der verschiedenen Suchparameter finden Sie in diesem Dokument im Abschnitt zu den Definitionen der Bildsuchparameter.

Diese Anfrage fragt die ersten fünf Ergebnisse (start=0&num=5) für den Suchbegriff „Affe“ ab (q=monkey) des Dateityps „.png“. 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/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: bmp, gif, png, jpg und svg.

Beispiele q=google&as_filetype=png

imgsz
Beschreibung

Optional: Gibt Bilder einer bestimmten Größe zurück, wobei Größe einer der folgenden Werte sein kann:

  • icon (klein)
  • small|medium|large|xlarge (mittel)
  • xxlarge (groß)
  • huge (extragroß)

Beispiele q=google&as_filetype=png&imgsz=icon

imgtype
Beschreibung

Optional: Gibt Bilder eines der folgenden Typen zurück:

  • clipart (Clipart)
  • face (Gesicht)
  • lineart (linear)
  • news (Nachrichten)
  • photo (Foto)

Beispiele q=google&as_filetype=png&imgtype=photo

imgc
Beschreibung

Optional: Gibt Schwarz-Weiß-, Graustufen- oder Farbbilder zurück:

  • mono (Schwarz-Weiß)
  • gray (Graustufen)
  • color (Farbe)

Beispiele q=google&as_filetype=png&imgc=gray

imgcolor
Beschreibung

Optional: Gibt Bilder einer bestimmten dominanten Farbe zurück:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
Beispiele q=google&as_filetype=png&imgcolor=yellow

as_rights
Beschreibung

Optional: Lizenzbasierte Filter. Unterstützte Werte sind:

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived

Beispiele q=cats&as_filetype=png&as_rights=cc_attribute

Anfragelimits

Die folgende Tabelle zeigt Einschränkungen für die Suchanfragen, die Sie an Google senden:

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 festlegen, werden nur 20 Ergebnisse zurückgegeben. Bis mehr Ergebnisse zu erhalten, müssten Sie mehrere Anfragen Wert des Parameters start erhöhen mit für jede Anfrage.

Präsentation: Abfragen und Ergebnisse internationalisieren

Mit Google WebSearch können Sie nach Dokumenten in in mehreren Sprachen. Sie können die Zeichencodierung angeben, werden verwendet, um deine HTTP-Anfrage zu interpretieren und deine XML-Antwort zu codieren (mit den Suchbegriffen ie und oe) Parameter). Sie können die Ergebnisse auch so filtern, dass nur Dokumente enthalten sind die in bestimmten Sprachen geschrieben sind.

In den folgenden Abschnitten werden Probleme bei der Suche in mehrere Sprachen:

Zeichencodierung

Server senden Daten wie Webseiten an User-Agents wie Browser als Folge codierter Byte. Der User-Agent decodiert dann in eine Folge von Zeichen umwandeln. Wenn Sie Anfragen an den WebSearch-Dienst können Sie die Codierungsschemas für Ihre und für die XML-Antwort, die Sie erhalten.

Mit dem Anfrageparameter ie können Sie Codierungsmechanismus für die Zeichen in Ihrer HTTP-Anfrage. Sie können Verwenden Sie auch den Parameter oe, um die Codierung anzugeben. Schema, mit dem Google Ihre XML-Antwort codieren soll. Wenn Sie Verwenden Sie ein anderes Codierungsschema als ISO-8859-1 (oder latin1). Achten Sie darauf, dass Sie die richtigen Werte angeben. für die Parameter ie und oe.

Hinweis:Wenn Sie eine Suchfunktion für mehrere Sprachen verwenden, empfehlen wir die Verwendung des Codierungswerts utf8 (UTF-8) für die Parameter ie und oe festlegen.

Weitere Informationen finden Sie im Abschnitt Zeichen finden Sie im Anhang 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 Oberfläche. Der Wert des Parameters hl kann sich auf XML-Suchergebnisse auswirken, insbesondere auf internationale Suchanfragen, wenn die Spracheinschränkung (über den Parameter lr) nicht explizit angegeben ist. In solchen Fällen Fälle, in denen der hl-Parameter Suchergebnisse bewerben kann in derselben Sprache wie die Eingabesprache des Nutzers angezeigt.

Wir empfehlen, den hl-Parameter explizit festzulegen in den Suchergebnissen angezeigt, damit Google in den Suchergebnissen.

Weitere Informationen finden Sie auf der Seite Unterstützte Schnittstelle Sprachen finden Sie eine vollständige Liste der gültigen Werte für den hl-Parameter.

Nach Dokumenten in bestimmten Sprachen suchen

Mit dem Anfrageparameter lr können Sie Suchergebnisse auf Dokumente zu beschränken, die in einer bestimmten Sprache oder eine Gruppe von Sprachen.

Der Parameter lr unterstützt Boolesche Operatoren, damit Sie Folgendes angeben können: mehrere Sprachen, die bei der Suche berücksichtigt (oder ausgeschlossen) werden sollen Ergebnisse.

Die folgenden Beispiele zeigen, wie Sie Boolesche Operatoren verwenden können, um Dokumente in Sprachen sprechen.

Für japanische Dokumente:

lr=lang_jp

Bei Dokumenten auf Italienisch oder Deutsch:

lr=lang_it|lang_de

Dokumente, die nicht auf Ungarisch oder Tschechisch verfasst sind:

lr=(-lang_hu).(-lang_cs)

Weitere Informationen finden Sie in der Sprachsammlung Werte enthält eine vollständige Liste der möglichen Werte für den Parameter lr und den Booleschen Wert Operatoren. .

Vereinfachtes Chinesisch und traditionelles Chinesisch sind zwei Schreibvarianten der chinesischen Sprache. Das gleiche Konzept kann in für jede Variante. Bei einer Suchanfrage in einer der Varianten kann WebSearch Ergebnisse zurückgeben, die Seiten in beiden Varianten.

So verwenden Sie dieses Feature:

  1. Legen Sie den Anfrageparameter c2coff auf 0 fest.
    und
  2. Führen Sie einen der folgenden Schritte aus:
    • Legen Sie den Anfrageparameter lr nicht fest
      oder
    • Setzen Sie den Anfrageparameter lr auf lr=lang_zh-TW|lang_zh-CN.

Das folgende Beispiel zeigt die Abfrageparameter, die Sie in einer Anfrage für Ergebnisse angeben würden in vereinfachtem und traditionellem Chinesisch. (Beachten Sie, dass zusätzlich erforderliche Informationen wie wie client, ist im Beispiel nicht enthalten.)

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

Ergebnisse filtern

Die Google WebSearch bietet eine Reihe von Möglichkeiten zum Filtern Ihrer Suche. Ergebnisse:

Automatisches Filtern von Suchergebnissen

Um Ihnen die bestmöglichen Suchergebnisse zu liefern, verwendet zwei Verfahren zur automatischen Filterung von Suchergebnissen, die im Allgemeinen als unerwünscht eingestuft werden:

  • Duplizierte Inhalte: Wenn mehrere Dokumente den Informationen enthalten, dann wird nur das relevanteste Dokument die in Ihren Suchergebnissen enthalten sind.

  • Host-Crowding: Wenn es viele Suchergebnisse aus der zeigt Google möglicherweise nicht alle Ergebnisse von dieser Website an oder Ergebnisse weiter unten in
    anzeigen ein höheres Ranking als sonst.

Wir empfehlen, diese Filter für typische Suchanfragen aktiviert zu lassen da die Filter die Qualität der meisten Suchanfragen Ergebnisse. Sie können diese automatischen Filter jedoch umgehen, indem Sie den Suchparameter Filter auf 0 in Ihrem Suchanfrage.

Nach Sprache und Land filtern

Der Google WebSearch-Dienst gibt Ergebnisse aus einem Masterindex von zurück. alle Webdokumente. Der Masterindex enthält Untersammlungen von Dokumente, die nach bestimmten Attributen gruppiert sind, einschließlich Sprache und Herkunftsland.

Sie können die Anfrageparameter lr und cr verwenden, um Suchergebnisse auf untergeordnete Sammlungen von Dokumente, die in bestimmten Sprachen geschrieben sind oder aus in bestimmten Ländern.

Google WebSearch ermittelt die Sprache eines Dokuments anhand folgender Daten:

  • Die Top-Level-Domain (TLD) der Dokument-URL
  • Sprach-Meta-Tags innerhalb des Dokuments
  • die im Haupttext des Dokuments verwendete primäre Sprache


Weitere Informationen finden Sie in der Definition des Parameters lr, im Abschnitt zur Suche nach Dokumente, die in bestimmten Sprachen verfasst sind, und die Werte der Spracherfassung, die werden als Werte für den Parameter lr verwendet, Informationen zum Einschränken von Ergebnissen auf Grundlage der Sprache.

Google WebSearch ermittelt das Land eines Dokuments anhand folgender Informationen:

  • Die Top-Level-Domain (TLD) der Dokument-URL
  • Der geografische Standort der IP-Adresse des Webservers

Weitere Informationen finden Sie in der Definition des Parameters cr und in der Erfassung des Landes Werte, die als Werte für den Parameter cr verwendet werden können, um weitere Informationen zum Einschränken der Ergebnisse nach Land von Ursprung.

Hinweis:Sie können Sprachen und Länderwerte, um Ihre Suchergebnisse anzupassen. Für Sie können z. B. Dokumente in französischer Sprache anfordern, aus Frankreich oder Kanada kommen oder aus den Niederlanden und sind nicht auf Englisch verfasst. Die Parameter lr und cr unterstützen beide Boolesche Operatoren.

Filtern nicht jugendfreier Inhalte mit SafeSearch

Viele Google-Kunden möchten keine Suchergebnisse für Websites mit Inhalten nur für Erwachsene. Mit unserem SafeSearch-Filter können Sie für Suchergebnisse mit nicht jugendfreien Inhalten suchen und diese entfernen. Die Filter von Google nutzen eine eigene Technologie, um Keywords, Wortgruppen und und URLs. Keine Filter sind zu 100 % genau. SafeSearch Sie entfernen den überwiegenden Teil nicht jugendfreier Inhalte aus Ihrer Suche. Ergebnisse.

Google ist bestrebt, SafeSearch so aktuell und umfangreich wie möglich zu gestalten möglich, indem sie kontinuierlich das Web crawlen und Updates integrieren, aus Nutzervorschlägen.

SafeSearch ist in den folgenden Sprachen verfügbar:

Niederländisch
Englisch
Französisch
Deutsch
Italienisch
Portugiesisch (Brasilien)
Spanisch
Chinesisch (traditionell)

Sie können anpassen, wie stark Google Ihre Ergebnisse filtert Inhalte nur für Erwachsene mit dem Suchparameter safe. In der folgenden Tabelle wird erläutert, wie die SafeSearch-Einstellungen von Google -Einstellungen auf Ihre Suchergebnisse auswirken:

SafeSearch-Stufe Beschreibung
hoch Aktiviert eine strengere Version von SafeSearch.
mittel Blockiert Webseiten, die folgenden Text enthalten: Pornografie und andere explizite sexuelle Inhalte.
deaktiviert Nicht jugendfreie Inhalte werden nicht herausgefiltert aus den Suchergebnissen entfernt.

* Die SafeSearch-Standardeinstellung ist deaktiviert.

Wenn SafeSearch aktiviert ist und Sie Websites finden, die anstößige Inhalte enthält, senden Sie eine E-Mail an safesearch@google.com an die URL der Website. die Website untersuchen.

XML-Ergebnisse

Google XML-Ergebnis-DTD

Google verwendet die gleiche DTD, um das XML-Format für alle Typen von in den Suchergebnissen. Viele der Tags und Attribute gelten für alle Suchtypen. Einige Tags gelten jedoch nur für bestimmte Suchtypen. Daher sind die Definitionen in der DTD möglicherweise weniger stark einschränkend als die Definitionen in diesem Dokument.

In diesem Dokument werden die Aspekte der DTD beschrieben, die relevant für für die Websuche. Wenn Sie in der DTD arbeiten, WebSearch können Sie Tags und Attribute, die nicht die hier dokumentiert sind. Wenn sich die Definition zwischen DTD und der Dokumentation lesen, wird in diesem Dokument vermerkt.

Google kann XML-Ergebnisse mit oder ohne Verweis auf die neueste DTD. Die DTD ist ein Leitfaden für Administratoren der Suche und XML-Parser die XML-Ergebnisse von Google verstehen. Da die XML-Datei von Google Da sich die Grammatik von Zeit zu Zeit ändern kann, sollten Sie die Einstellungen Parser verwendet, um jedes XML-Ergebnis mithilfe der DTD zu validieren.

Außerdem sollten Sie den XML-Parser nicht für das Abrufen der DTD bei jeder Übermittlung einer Suchanfrage. Google aktualisiert die DTD und diese Anfragen verursachen unnötige Verzögerungen und Bandbreiten, Anforderungen.

Google empfiehlt, für XML-Ergebnisse das Ausgabeformat xml_no_dtd zu verwenden. Wenn Sie in der Suchanfrage das Ausgabeformat xml angeben, der einzige Unterschied besteht darin, dass die folgenden Zeilen in die XML-Ergebnisse eingefügt werden:

<!DOCTYPE GSP SYSTEM "google.dtd">

Sie finden die neueste DTD unter http://www.google.com/google.dtd.

Beachten Sie, dass möglicherweise nicht alle Funktionen in der DTD derzeit verfügbar sind oder unterstützt werden.

Informationen zur XML-Antwort

  • Alle Elementwerte sind gültiger HTML-Code, der für die Anzeige geeignet ist, es sei denn, die in den XML-Tag-Definitionen angegeben sind.
  • Einige Elementwerte sind URLs, die vor dem Hochladen mit HTML codiert werden müssen. angezeigt werden.
  • Der XML-Parser sollte nicht dokumentierte Attribute und Tags ignorieren. Dadurch kann Ihre Anwendung ohne Änderungen weiter ausgeführt werden. wenn Google der XML-Ausgabe weitere Funktionen hinzufügt.
  • Bestimmte Zeichen müssen maskiert werden, wenn sie als Werte in XML-Tags. Ihr XML-Prozessor sollte diese Entitäten zurück in den die entsprechenden Zeichen enthalten. Wenn Sie Entitäten nicht ordnungsgemäß konvertieren, kann der Browser beispielsweise das & als "&amp;" verwendet. Der XML-Code Standard dokumentiert diese Zeichen: diese Zeichen sind wie in der folgenden Tabelle dargestellt:

    Zeichen Maskierte Formulare Entität Zeichencode
    Kaufmännisches Und-Zeichen & &amp; &#38;
    Einfaches Anführungszeichen ' &apos; &#39;
    Doppeltes Anführungszeichen " &quot; &#34;
    Größer-als-Zeichen > &gt; &#62;
    Kleiner-als-Zeichen < &lt; &#60;

XML-Ergebnisse für reguläre und erweiterte Suchanfragen

Reguläre/erweiterte Suche: Beispielanfrage und XML-Ergebnis

Diese Beispiel-WebSearch-Anfrage fragt zehn Ergebnisse (num=10) ab. zum Suchbegriff „socer“ (q=socer), was das Wort "Fußball" absichtlich falsch geschrieben.

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. Beachten Sie, dass es mehrere Kommentare im XML-Ergebnis, um anzuzeigen, an welchen Stellen bestimmte Tags die im Ergebnis enthalten sind.

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

Reguläre/erweiterte Suche: XML-Tags

XML-Antworten für reguläre Suchanfragen und erweiterte Suche -Anfragen verwenden beide denselben Satz von XML-Tags. Diese XML-Tags werden in das oben beschriebene XML-Beispiel und wird in den Tabellen unten erläutert.

Die XML-Tags unten sind alphabetisch nach Tag-Namen aufgelistet und alle Die Tag-Definition enthält eine Beschreibung des Tags, ein Beispiel für wie das Tag in einem XML-Ergebnis aussehen würde, und das Format der Inhalte. Wenn das Tag ein Subtag eines anderen XML-Tags ist Subtags oder Attribute, werden diese Informationen auch in in der Definitionstabelle des Tags.

Neben einigen Subtags in der Datei werden möglicherweise bestimmte Symbole angezeigt. Definitionen weiter unten. Diese Symbole haben folgende Bedeutungen:

? = optionales untergeordnetes Tag
* = keine oder mehr Instanzen des Subtags
+ = eine oder mehrere Instanzen des Subtags
A B C D Fr. G H I M M N P F F S T U X

anchor_text
Definition

Das Tag &lt;anchor_text&gt; gibt den Text an, der die Sie Nutzern präsentieren sollten, um eine Optimierung Label, das mit einem Suchergebnis verknüpft ist. Da Labels zur Verfeinerung nicht alphanumerische Zeichen durch Unterstriche ersetzen, sollten Sie den Wert des <label>-Tags auf der Benutzeroberfläche anzeigen Stattdessen sollten Sie den Wert &lt;anchor_text&gt;-Tag

Beispiel <anchor_text>Golf Kurse</anchor_text>
Subtag von FacetItem
Inhaltsformat Text

BLOCKIEREN
Definition

Dieses Tag schließt den Inhalt eines Blocks in einer Fließ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 einer URL im U-Subtag und Ankertext im L-Subtag).

Teiltags T, U, L
Subtag von BODY_LINE
Inhaltsformat Leer

BODY_LINE
Definition

Dieses Tag schließt den Inhalt einer Zeile im Hauptteil des gesponserten Ergebnisses ein. Jeder Textkörper besteht aus mehreren BLOCK-Tags, die entweder etwas Text oder einen Link mit URL und Ankertext enthalten.

Teiltags BLOCKIEREN*
Subtag von SL_MAIN
Inhaltsformat Leer

C
Definition

Das Tag &lt;C&gt; gibt an, dass der WebSearch-Dienst kann eine im Cache gespeicherte Version dieser Suchergebnis-URL abrufen. Sie können nicht im Cache gespeicherte Seiten über die XML API abrufen, Nutzer können aber auf www.google.com. Inhalte.

Attribute
Name Format Beschreibung
SZ Text (Ganzzahl + "k") Gibt die Größe der im Cache gespeicherten Version an des Suchergebnisses in Kilobyte ("k").
Kundennummer Text Kennzeichnet ein Dokument im Google-Cache. Um das Dokument aus dem Cache abzurufen, senden Sie einen Suchbegriff, der erstellt wurde als folgt:
cache:CIDtext:escapedURL

Die maskierte URL ist im UE-Tag verfügbar.

Beispiel <C SZ="6k" CID=&quot;kvOXK_cYSSgJ&quot;
Subtag von HAT
Inhaltsformat Leer

C2C
Definition Das <C2C>-Tag gibt an, dass Das Ergebnis bezieht sich auf eine Seite in traditionellem Chinesisch. Dieses Tag wird nur angezeigt, wenn Vereinfacht und traditionell Chinesische Suche ist aktiviert. Weitere Informationen zum Aktivieren und Deaktivieren von Filtern finden Sie in der Definition des Abfrageparameters c2coff. zum Deaktivieren dieser Funktion.
Inhaltsformat Text

Kontext
Definition

Das Tag &lt;Context&gt; enthält eine Liste mit Suchfilter-Labels, die mit einer Reihe von Suchergebnissen verknüpft sind.

Beispiel &lt;Context&gt;
Teiltags title, Facet+
Inhaltsformat Container

CRAWLDATUM
Definition

Das &lt;CRAWLDATE&gt;-Tag gibt das Datum an, an dem der Seite zuletzt gecrawlt wurde. CRAWLDATE wird nicht für jede Suchergebnisseite zurückgegeben.

Beispiel <CRAWLDATE>21. Mai, 2005</CRAWLDATE>
Subtag von F
Inhaltsformat Text

DI
Definition

Das Tag &lt;DI&gt; schließt das Open Directory Project ein. (ODP) Kategorieinformationen für ein einzelnes Suchergebnis.

Beispiel &lt;DI&gt;
Teiltags DT?, DS?
Subtag von HAT
Inhaltsformat Leer

DS
Definition

Das &lt;DS&gt;-Tag liefert eine Zusammenfassung Kategorie im ODP-Verzeichnis enthalten.

Beispiel <DS>Posten Sie Ihre &lt;b&gt;Fußball&lt;/b&gt; direkt im Internet.</DS>
Subtag von DI
Inhaltsformat Text (kann HTML enthalten)

Gerätebaum
Definition

Das &lt;DT&gt;-Tag gibt den Titel für eine einzelne im ODP-Verzeichnis aufgelistet sind.

Beispiel &lt;DT&gt;SoccerConnection.net&lt;/DT&gt;
Subtag von DI
Inhaltsformat Text (kann HTML enthalten)

Attribut
Definition

Das <Facet>-Tag enthält eine logische Gruppierung von &lt;FacetItem&gt;-Tags. Sie können erstellen Gruppen mithilfe der Programmable Search Engine Format der XML-Spezifikation der Engine Wenn Sie diese Gruppierungen, results_xml_tag_Context><Context> Tag wird beruhigen bis zu vier <Facet>-Tags. Die Elemente in jedem <Facet>-Tag werden zu Anzeigezwecken gruppiert, haben aber möglicherweise keinen logischen Wert Beziehung.

Beispiel <Facette>
Teiltags FacetItem+, title+
Subtag von Kontext
Inhaltsformat Container

FacetItem
Definition

Im Tag &lt;FacetItem&gt; werden Informationen zu einem Suchfilter-Label, das mit einer Reihe von Suchergebnissen verknüpft ist.

Beispiel &lt;FacetItem&gt;
Teiltags label, anchor_text+
Subtag von Attribut
Inhaltsformat FacetItem

FI
Definition Das &lt;FI&gt;-Tag dient als Markierung gibt an, ob für die Suche Dokumentfilter durchgeführt wurden. Weitere Informationen finden Sie im Abschnitt Automatisches Filtern. in diesem Dokument finden Sie weitere Informationen zu den Google-Suchergebnissen. Filter.
Beispiel <FI />
Subtag von RES
Inhaltsformat Leer

Gesponserte Werbung in Gmail
Definition

&lt;GSP&gt;-Tag kapselt alle in den XML-Suchergebnissen von Google zurückgegebenen Daten ein. "GSP" ist eine Abkürzung für „Google Search Protocol“.

Attribute
Name Format Beschreibung
V Text (Ganzzahl) Das Attribut VER gibt die Version der Ausgabe der Suchergebnisse an. Die Die aktuelle Ausgabeversion ist „3.2“.
Beispiel <GSP VER="3.2">
Teiltags PARAM+, Q, RES?, TM
Inhaltsformat Leer

HAT
Definition Das &lt;HAS&gt;-Tag enthält Informationen zu Sondersuchanfragen Anfrageparameter, die für eine bestimmte URL unterstützt werden.

Hinweis:Die Definition des Begriffs <HAS> für WebSearch ist restriktiver als die DTD.

Teiltags DI?, L?, C?, RT?
Subtag von F

ISURL
Definition Google gibt das &lt;ISURL&gt;-Tag zurück. wenn es sich bei der verknüpften Suchanfrage um eine URL handelt.
Subtag von GSP
Inhaltsformat Leer

L
Definition Das Vorhandensein des &lt;L&gt;-Tags zeigt an, dass der WebSearch-Dienst andere Websites finden kann, die einen Link zu diese Suchergebnis-URL. Um solche Websites zu finden, verwenden Sie den speziellen Suchbegriff link:.
Subtag von HAT
Inhaltsformat Leer

Label
Definition

Das Tag <label> gibt ein Label für die Optimierung an. mit dem Sie die angezeigten Suchergebnisse filtern können. Zur Verwendung ein Suchfilter-Label, fügen Sie den String more:[[label tag value]] zu Wert des Parameters q in Ihrer HTTP-Anfrage an Google als wie im folgenden Beispiel dargestellt. Dieser Wert muss bevor Sie die Anfrage an Google senden.

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
q=Palm+Springs+more%3Agolf_courses

Hinweis: Das <label>-Tag ist nicht dasselbe wie Das &lt;Label&gt;-Tag, das ein Label zur Optimierung identifiziert die mit einer bestimmten URL in Ihren Suchergebnissen verknüpft sind.

Beispiel &lt;label&gt;golf_courses&lt;/label&gt;
Subtag von FacetItem
Inhaltsformat Text

lang
Definition

Das Tag &lt;LANG&gt; enthält eine nach bestem Wissen und Gewissen von Google ermittelte die Sprache des Suchergebnisses.

Beispiel <LANG>de</LANG>
Subtag von F
Inhaltsformat Text

M
Definition

Das &lt;M&gt;-Tag gibt die geschätzte Gesamtsumme an. Anzahl der Ergebnisse für die Suche.

Hinweis : Diese Schätzung ist möglicherweise nicht genau.

Beispiel <M>16200000</M>
Subtag von RES
Inhaltsformat Text

Neugeborene
Definition

Das &lt;NB&gt;-Tag enthält Navigationsinformationen, also Links zur nächsten Suchergebnisseite oder zur vorherigen Seite für den Ergebnissatz.

Hinweis:Dieses Tag ist nur vorhanden. wenn weitere Ergebnisse verfügbar sind.

Beispiel &lt;NB&gt;
Teiltags NU?, PU?
Subtag von RES
Inhaltsformat Leer

NU
Definition

Das &lt;NU&gt;-Tag enthält einen relativen Link zum der nächsten Seite der Suchergebnisse.

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 &lt;PARAM&gt;-Tag einen Eingabeparameter identifiziert, der in der zugehörigen HTTP-Anfrage gesendet wurde durch das XML-Ergebnis. Informationen zum Parameter sind in die Tag-Attribute – name, value, original_value – Ein PARAM-Tag für jeden in der HTTP-Anfrage übermittelten Parameter.

Attribute
Name Format Beschreibung
name Text Name des Eingabeparameters.
Wert HTML HTML-formatierte Version der Eingabe Parameterwert eingeben.
original_value Text Ursprüngliche URL-Escaping-Version des Eingabeparameterwerts
Beispiel <PARAM name="cr" value=&quot;countryNZ&quot; original_value="LandNZ"
Subtag von GSP
Inhaltsformat Komplex

PU
Definition

Das &lt;PU&gt;-Tag stellt einen relativen Link zum der vorherigen Seite der Suchergebnisse.

Beispiel <PU>/search?q=flowers&num=10&hl=de&output=xml
&client=test&start=10</PU>
Subtag von Hinweis
Inhaltsformat Text (relative URL)

Q
Definition

Das Tag &lt;Q&gt; gibt die Suchanfrage an. in der mit dem XML-Ergebnis verknüpften HTTP-Anfrage gesendet.

Beispiel

<Q>Pizza</Q>

Subtag von GSP
Inhaltsformat Text

R
Definition

Das Tag &lt;R&gt; enthält die Details eines in den Suchergebnissen.

Hinweis:Die Definition des <R>-Tags für WebSearch ist restriktiver als die DTD.

Attribute
Name Format Beschreibung
N Text (Ganzzahl) Gibt den Index (1-basiert) dieses in den Suchergebnissen.
MIME Text Gibt den MIME-Typ der Suche an Ergebnis.
Teiltags U, UE, T?, CRAWLDATE, S?, LANG?, HAT
Subtag von RES

WID
Definition

Das Tag &lt;RES&gt; schließt die Gruppe der einzelnen Suchergebnisse und Details zu diesen Ergebnissen.

Attribute
Name Format Beschreibung
SN Text (Ganzzahl) Gibt den Index (1-basiert) des erstes Suchergebnis in dieser Ergebnismenge.
DE Text (Ganzzahl) Gibt den Index (1-basiert) der letzten in diesem Ergebnissatz zurückgegebenes Suchergebnis.
Beispiel <RES SN="1" DE="10">
Teiltags M, FI?, XT?, Hinweis?, R*
Subtag von GSP
Inhaltsformat Leer

S
Definition

Das &lt;S&gt;-Tag enthält einen Auszug für eine Suche. Ergebnis mit fett hervorgehobenen Suchbegriffen. Zeilenumbrüche sind im Auszug für ordnungsgemäßen Textumbruch enthalten.

Beispiel <S>Washington (CNN) – Ein Gebot zum Beenden der Unstimmigkeiten im Senat über die Präsidentschaftswahl &lt;b&gt;Bush&#39;s&lt;/b&gt; dass die Richter-Entscheidungen Lass fünf Nominierte zu einer endgültigen Abstimmung gelangen, ohne die &lt;b&gt;...&lt;b&gt;...&lt;/b&gt;<S>
Subtag von F
Inhaltsformat Text (HTML)

SL_MAIN
Definition

Dieses Tag schließt den Inhalt eines Werbeergebnisses ein. Wird zum Parsen von bevorzugten Suchergebnissen verwendet. Der Ankertext und die URL des Titellinks sind in den Subtags T und U enthalten. Die Zeilen mit dem Textkörper und den Links sind in BODY_LINE-Subtags enthalten.

Teiltags BODY_LINE*, T, U
Subtag von SL_RESULTS
Inhaltsformat Leer

SL_RESULTS
Definition

Container-Tag für hochgestufte Ergebnisse. Eine dieser Optionen wird angezeigt, wenn Ihre Suchergebnisse eine Werbung enthalten. Das Subtag SL_MAIN enthält die Hauptergebnisdaten.

Teiltags SL_MAIN*
Subtag von F
Inhaltsformat Leer

Rechtschreibung
Definition

Das Tag <Spelling> schließt ein alternatives Rechtschreibvorschlag für die eingereichte Suchanfrage. Dieses Tag erscheint nur auf auf der ersten Suchergebnisseite. Rechtschreibvorschläge sind verfügbar in Englisch, Chinesisch, Japanisch und Koreanisch.

Hinweis:Google gibt nur Rechtschreibvorschläge aus für Abfragen, bei denen sich der Wert des Parameters gl befindet Kleinbuchstaben.

Beispiel <Rechtschreibung>
Teiltags Vorschlag
Subtag von GSP
Inhaltsformat Leer

Vorschlag
Definition Das &lt;Suggestion&gt;-Tag enthält ein alternativer Rechtschreibvorschlag für die eingereichte Suchanfrage. Sie können die Content des Tags, um dem Nutzer der Suche die alternative Schreibweise vorzuschlagen. Der Wert des Attributs q ist der Rechtschreibvorschlag mit URL-Escaping, den Sie als Suchbegriff verwenden können.
Attribute
Name Format Beschreibung
q Text Das Attribut q gibt den Version des Rechtschreibvorschlags mit URL-Escaping
Beispiel <Vorschlag q=&quot;soccer&quot;&gt;&amp;lt;b&amp;gt;&amp;lt;i&amp;gt;soccer&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;&lt;/Suggestion&gt;
Subtag von Rechtschreibung
Inhaltsformat Text (HTML)

T
Definition Das &lt;T&gt;-Tag enthält den Titel. des Ergebnisses.
Beispiel <T>Amicis Ostküste Pizzeria</T>
Subtag von F
Inhaltsformat Text (HTML)

Titel
Definition

Als untergeordnetes Element von &lt;Context&gt; enthält das &lt;Context&gt;-Tag den Namen Ihrer Programmable Search Engine.

Als untergeordnetes Element von <Facet> bietet das Tag <title> einen Titel für eine Reihe von Attributen.

Beispiel

Als untergeordnetes Element von <Context>: <title>My Search Engine&lt;/title&gt;

Als untergeordnetes Element von <Facet>: <title>facet Titel</title>

Subtag von Context, Facet.
Inhaltsformat Text

TM
Definition

Das &lt;TM&gt;-Tag gibt die gesamte Serverzeit an. die erforderlich sind, um Suchergebnisse zurückzugeben, gemessen in Sekunden.

Beispiel <TM>0,100445</TM>
Subtag von GSP
Inhaltsformat Text (Gleitkommazahl)

TT
Definition Das &lt;TT&gt;-Tag ermöglicht eine Suche Tipp:
Beispiel <TT>&lt;i&gt;Tipp: Für die meisten Browsern wird das Ergebnis durch Drücken der Eingabetaste die Suchschaltfläche.&lt;/i&gt;</TT>
Subtag von GSP

U
Definition Über das &lt;U&gt;-Tag wird die URL des Suchergebnisses.
Beispiel &lt;U&gt;http://www.dominos.com/&lt;/U&gt;
Subtag von F
Inhaltsformat Text (absolute URL)

UD
Definition

Das &lt;UD&gt;-Tag liefert die IDN-codierten (International Domain Name) URL für das Suchergebnis. Der Wert ermöglicht Domains in der jeweiligen Landessprache angezeigt werden. Beispiel: Der Parameter Die IDN-codierte URL http://www.%E8%8A%B1%E4%BA%95.com könnte decodiert und als http://www.花井鮨.com angezeigt werden. Dieses &lt;UD&gt;-Tag wird nur in Suchergebnisse für in denen der Parameter ud enthalten war.

Hinweis:Dies ist eine Betafunktion.

Beispiel &lt;UD&gt;http://www.%E8%8A%B1%E4%BA%95.com/&lt;/UD&gt;
Subtag von F
Inhaltsformat Text (IDN-codierte URL)

UE
Definition Das &lt;UE&gt;-Tag gibt die URL an. des Suchergebnisses. Der Wert ist mit URL-Escaping versehen, sodass er für zur Übergabe als Suchparameter in einer URL.
Beispiel &lt;UE&gt;http://www.dominos.com/&lt;/UE&gt;
Subtag von F
Inhaltsformat Text (URL mit URL-Escaping)

XT
Definition Das &lt;XT&gt;-Tag gibt an, dass der Die geschätzte Gesamtzahl der Ergebnisse, wie durch das Tag M angegeben, entspricht tatsächlich Gesamtzahl der Ergebnisse. Unter Automatische Weitere Informationen finden Sie im Abschnitt „Filtern“ dieses Dokuments.
Beispiel <XT />
Subtag von RES
Inhaltsformat Leer


XML-Ergebnisse für Bildersuche-Anfragen

In dieser Beispielanfrage für ein Bild werden fünf Ergebnisse (num=5) zum Suchbegriff „Affe“ angefordert. (q=Affe).

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 Bildsuchanfragen verwendet werden.

Neben einigen Subtags in der Datei werden möglicherweise bestimmte Symbole angezeigt. Definitionen weiter unten. Diese Symbole haben folgende Bedeutungen:

? = optionales untergeordnetes Tag
* = keine oder mehr Instanzen des Subtags
+ = eine oder mehrere Instanzen des Subtags

RG
Definition

Das &lt;RG&gt;-Tag schließt die Details eines einzelnen Ergebnisses der Bildersuche ein.

Attribute
Name Format Beschreibung
N Text (Ganzzahl) Gibt den Index (1-basiert) dieses in den Suchergebnissen.
MIME Text Gibt den MIME-Typ der Suche an Ergebnis.
Subtag von RES
RU
Definition

Das Tag <RU tag> schließt Details zu jedem Bildsuchergebnis ein.

Subtag von F