Search

Antwort auf eine benutzerdefinierte Suchanfrage

JSON-Darstellung 
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
Felder
kind

string

Eindeutige Kennung für den Typ des aktuellen Objekts. Für diese API ist er customsearch#search.
url

object

Das OpenSearch-URL-Element, das die Vorlage für diese API definiert.
url.type

string

Der MIME-Typ der OpenSearch-URL-Vorlage für die Custom Search JSON API.
url.template

string

Die eigentliche OpenSearch-Vorlage für diese API.
queries

object

Enthält einen oder mehrere Sätze von Abfragemetadaten, die nach Rollenname aufgeschlüsselt sind. Zu den möglichen Rollennamen gehören request, das durch die OpenSearch-Abfragerollen definiert wird, und zwei benutzerdefinierte Rollen: nextPage und previousPage.
queries.previousPage[]

object

Metadaten, die die vorherige Ergebnisseite darstellen, falls zutreffend.
queries.previousPage[].title

string

Eine Beschreibung der Abfrage.
queries.previousPage[].totalResults

string (int64 format)

Geschätzte Gesamtzahl der Suchergebnisse. Sind möglicherweise nicht genau.
queries.previousPage[].searchTerms

string

Vom Nutzer eingegebene Suchbegriffe
queries.previousPage[].count

integer

Anzahl der in diesem Satz zurückgegebenen Suchergebnisse.
queries.previousPage[].startIndex

integer

Der Index der aktuellen Gruppe von Suchergebnissen in der gesamten Gruppe von Ergebnissen, wobei der Index des ersten Ergebnisses 1 ist.
queries.previousPage[].startPage

integer

Die Seitenzahl dieser Gruppe von Ergebnissen, wobei die Seitenlänge durch das Attribut count festgelegt wird.
queries.previousPage[].language

string

Die Sprache der Suchergebnisse.
queries.previousPage[].inputEncoding

string

Die für Suchanfragen unterstützte Zeichencodierung.
queries.previousPage[].outputEncoding

string

Die für Suchergebnisse unterstützte Zeichencodierung.
queries.previousPage[].safe

string

Legt die SafeSearch-Ebene fest, die zum Herausfiltern nicht jugendfreier Ergebnisse verwendet wird. Dies ist eine benutzerdefinierte Eigenschaft, die nicht in der OpenSearch-Spezifikation definiert ist. Gültige Parameterwerte sind:

  • "off": SafeSearch deaktivieren

  • "active": SafeSearch aktivieren
queries.previousPage[].cx

string

Die Kennung einer Suchmaschine, die mit dem Steuerfeld der Programmable Search Engine erstellt wurde. Dies ist eine benutzerdefinierte Eigenschaft, die in der OpenSearch-Spezifikation nicht definiert ist. Dieser Parameter ist erforderlich.
queries.previousPage[].sort

string

Gibt an, dass Ergebnisse gemäß dem angegebenen Ausdruck sortiert werden sollen. Sortieren Sie beispielsweise nach Datum.
queries.previousPage[].filter

string

Aktiviert oder deaktiviert die automatische Filterung von Google-Suchergebnissen Weitere Informationen zu den Suchergebnisfiltern von Google finden Sie unter Automatische Filterung. Gültige Werte für diesen Parameter sind:

  • 0: deaktiviert

  • 1: Aktiviert (Standardeinstellung)

Hinweis: Standardmäßig wendet Google Filter auf alle Suchergebnisse an, um die Qualität dieser Ergebnisse zu verbessern.
queries.previousPage[].gl

string

Steigt Suchergebnisse, deren Herkunftsland mit dem Parameterwert übereinstimmt. Eine Liste der gültigen Werte finden Sie unter Ländercodes.

Die Angabe eines gl-Parameterwerts in WebSearch-Anfragen sollte die Relevanz der Ergebnisse verbessern. Dies gilt insbesondere für internationale Kunden und insbesondere für Kunden in englischsprachigen Ländern außer den USA.
queries.previousPage[].cr

string

Beschränkt die Suchergebnisse auf Dokumente aus einem bestimmten Land. Sie können im Wert des Parameters cr Boolesche Operatoren verwenden.

Google WebSearch ermittelt das Land eines Dokuments anhand der folgenden Daten:

  • Top-Level-Domain (TLD) der Dokument-URL.

  • Der geografische Standort der IP-Adresse des Webservers.

Eine Liste der gültigen Werte für diesen Parameter finden Sie unter Länderparameterwerte (cr).
queries.previousPage[].googleHost

string

Gibt die Google-Domain an, auf die die Suche beschränkt werden soll, z. B. google.com, google.de oder google.fr.
queries.previousPage[].disableCnTwTranslation

string

Aktiviert oder deaktiviert die Funktion Chinesisch (vereinfacht und traditionell).

Unterstützte Werte:

  • 0: aktiviert (Standardeinstellung)

  • 1: deaktiviert
queries.previousPage[].hq

string

Hängt die angegebenen Suchbegriffe so an die Abfrage an, als wären sie mit einem logischen AND-Operator kombiniert.
queries.previousPage[].hl

string

Gibt die Sprache der Benutzeroberfläche (Hostsprache) Ihrer Benutzeroberfläche an. Wenn Sie diesen Parameter explizit festlegen, werden die Leistung und die Qualität Ihrer Suchergebnisse verbessert.

Weitere Informationen finden Sie im Abschnitt Schnittstellensprachen der Präsentation zur Internationalisierung von Abfragen und Ergebnissen und unter Unterstützte Schnittstellensprachen finden Sie eine Liste der unterstützten Sprachen.
queries.previousPage[].siteSearch

string

Beschränkt die Ergebnisse auf URLs von einer bestimmten Website.
queries.previousPage[].siteSearchFilter

string

Gibt an, ob Ergebnisse von der im sitesearch-Parameter genannten Website ein- oder ausgeschlossen werden sollen. Unterstützte Werte:

  • i: Websitecontent einschließen

  • e: Inhalte von der Website ausschließen
queries.previousPage[].exactTerms

string

Kennzeichnet eine Wortgruppe, die alle Dokumente in den Suchergebnissen enthalten müssen.
queries.previousPage[].excludeTerms

string

Kennzeichnet ein Wort oder eine Wortgruppe, das bzw. die in keinem Dokument in den Suchergebnissen angezeigt werden soll.
queries.previousPage[].linkSite

string

Gibt an, dass alle Ergebnisse einen Link zu einer bestimmten URL enthalten sollen.
queries.previousPage[].orTerms

string

Liefert zusätzliche Suchbegriffe, nach denen in einem Dokument gesucht werden soll, wobei jedes Dokument in den Suchergebnissen mindestens einen der zusätzlichen Suchbegriffe enthalten muss. Für diese Art von Abfrage können Sie auch den Suchbegriff Boolescher Operator OR verwenden.
queries.previousPage[].relatedSite

string

Gibt an, dass alle Suchergebnisse Seiten sein sollen, die sich auf die angegebene URL beziehen. Der Parameterwert muss eine URL sein.
queries.previousPage[].dateRestrict

string

Beschränkt die Ergebnisse auf URLs basierend auf dem Datum. Unterstützte Werte sind:

  • d[number]: Fordert Ergebnisse für die angegebene Anzahl der letzten Tage an.

  • w[number]: Fordert Ergebnisse für die angegebene Anzahl der letzten Wochen an.

  • m[number]: Fordert Ergebnisse für die angegebene Anzahl der letzten Monate an.

  • y[number]: Fordert Ergebnisse für die angegebene Anzahl vergangener Jahre an.
queries.previousPage[].lowRange

string

Gibt den Startwert für einen Suchbereich an. Verwende cse:lowRange und cse:highrange, um einen inklusiven Suchbereich von lowRange...highRange an die Abfrage anzuhängen.
queries.previousPage[].highRange

string

Gibt den Endwert für einen Suchbereich an. Verwende cse:lowRange und cse:highrange, um einen inklusiven Suchbereich von lowRange...highRange an die Abfrage anzuhängen.
queries.previousPage[].fileType

string

Beschränkt die Ergebnisse auf Dateien mit einer bestimmten Erweiterung. Google unterstützt u. a. die folgenden Dateitypen:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • MacWrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Rich-Text-Format (rtf)

  • Shockwave-Blitz (swf)

  • Text (ans, txt).

In Zukunft werden möglicherweise weitere Dateitypen hinzugefügt. Eine aktuelle Liste finden Sie immer in den häufig gestellten Fragen zu Dateitypen von Google.
queries.previousPage[].rights

string

Filter sind lizenzbasiert. Unterstützte Werte sind:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.previousPage[].searchType

string

Zulässige Werte sind web und image. Wenn keine Vorgabe erfolgt, werden die Ergebnisse auf Webseiten beschränkt.
queries.previousPage[].imgSize

string

Beschränkt die Ergebnisse auf Bilder einer bestimmten Größe. Unterstützte Werte:

  • icon (klein)

  • small | medium | large | xlarge (mittel)

  • xxlarge (groß)

  • huge (extragroß)
queries.previousPage[].imgType

string

Beschränkt die Ergebnisse auf Images eines bestimmten Typs. Unterstützte Werte:

  • clipart (Clip)

  • face (Gesicht)

  • lineart (Linienzeichnung)

  • photo (Foto)

  • animated (animiert)

  • stock (Aktie)
queries.previousPage[].imgColorType

string

Beschränkt die Ergebnisse auf Bilder eines bestimmten Farbtyps. Unterstützte Werte:

  • mono (Schwarz-Weiß)

  • gray (Graustufen)

  • color (Farbe)
queries.previousPage[].imgDominantColor

string

Beschränkt die Ergebnisse auf Bilder mit einer bestimmten dominanten Farbe. Unterstützte Werte:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
queries.request[]

object

Metadaten, die die aktuelle Anfrage darstellen.
queries.request[].title

string

Eine Beschreibung der Abfrage.
queries.request[].totalResults

string (int64 format)

Geschätzte Gesamtzahl der Suchergebnisse. Sind möglicherweise nicht genau.
queries.request[].searchTerms

string

Vom Nutzer eingegebene Suchbegriffe
queries.request[].count

integer

Anzahl der in diesem Satz zurückgegebenen Suchergebnisse.
queries.request[].startIndex

integer

Der Index der aktuellen Gruppe von Suchergebnissen in der gesamten Gruppe von Ergebnissen, wobei der Index des ersten Ergebnisses 1 ist.
queries.request[].startPage

integer

Die Seitenzahl dieser Gruppe von Ergebnissen, wobei die Seitenlänge durch das Attribut count festgelegt wird.
queries.request[].language

string

Die Sprache der Suchergebnisse.
queries.request[].inputEncoding

string

Die für Suchanfragen unterstützte Zeichencodierung.
queries.request[].outputEncoding

string

Die für Suchergebnisse unterstützte Zeichencodierung.
queries.request[].safe

string

Legt die SafeSearch-Ebene fest, die zum Herausfiltern nicht jugendfreier Ergebnisse verwendet wird. Dies ist eine benutzerdefinierte Eigenschaft, die nicht in der OpenSearch-Spezifikation definiert ist. Gültige Parameterwerte sind:

  • "off": SafeSearch deaktivieren

  • "active": SafeSearch aktivieren
queries.request[].cx

string

Die Kennung einer Suchmaschine, die mit dem Steuerfeld der Programmable Search Engine erstellt wurde. Dies ist eine benutzerdefinierte Eigenschaft, die in der OpenSearch-Spezifikation nicht definiert ist. Dieser Parameter ist erforderlich.
queries.request[].sort

string

Gibt an, dass Ergebnisse gemäß dem angegebenen Ausdruck sortiert werden sollen. Sortieren Sie beispielsweise nach Datum.
queries.request[].filter

string

Aktiviert oder deaktiviert die automatische Filterung von Google-Suchergebnissen Weitere Informationen zu den Suchergebnisfiltern von Google finden Sie unter Automatische Filterung. Gültige Werte für diesen Parameter sind:

  • 0: deaktiviert

  • 1: Aktiviert (Standardeinstellung)

Hinweis: Standardmäßig wendet Google Filter auf alle Suchergebnisse an, um die Qualität dieser Ergebnisse zu verbessern.
queries.request[].gl

string

Steigt Suchergebnisse, deren Herkunftsland mit dem Parameterwert übereinstimmt. Eine Liste der gültigen Werte finden Sie unter Ländercodes.

Die Angabe eines gl-Parameterwerts in WebSearch-Anfragen sollte die Relevanz der Ergebnisse verbessern. Dies gilt insbesondere für internationale Kunden und insbesondere für Kunden in englischsprachigen Ländern außer den USA.
queries.request[].cr

string

Beschränkt die Suchergebnisse auf Dokumente aus einem bestimmten Land. Sie können im Wert des Parameters cr Boolesche Operatoren verwenden.

Google WebSearch ermittelt das Land eines Dokuments anhand der folgenden Daten:

  • Top-Level-Domain (TLD) der Dokument-URL.

  • Der geografische Standort der IP-Adresse des Webservers.

Eine Liste der gültigen Werte für diesen Parameter finden Sie unter Länderparameterwerte (cr).
queries.request[].googleHost

string

Gibt die Google-Domain an, auf die die Suche beschränkt werden soll, z. B. google.com, google.de oder google.fr.
queries.request[].disableCnTwTranslation

string

Aktiviert oder deaktiviert die Funktion Chinesisch (vereinfacht und traditionell).

Unterstützte Werte:

  • 0: aktiviert (Standardeinstellung)

  • 1: deaktiviert
queries.request[].hq

string

Hängt die angegebenen Suchbegriffe so an die Abfrage an, als wären sie mit einem logischen AND-Operator kombiniert.
queries.request[].hl

string

Gibt die Sprache der Benutzeroberfläche (Hostsprache) Ihrer Benutzeroberfläche an. Wenn Sie diesen Parameter explizit festlegen, werden die Leistung und die Qualität Ihrer Suchergebnisse verbessert.

Weitere Informationen finden Sie im Abschnitt Schnittstellensprachen der Präsentation zur Internationalisierung von Abfragen und Ergebnissen und unter Unterstützte Schnittstellensprachen finden Sie eine Liste der unterstützten Sprachen.
queries.request[].siteSearch

string

Beschränkt die Ergebnisse auf URLs von einer bestimmten Website.
queries.request[].siteSearchFilter

string

Gibt an, ob Ergebnisse von der im sitesearch-Parameter genannten Website ein- oder ausgeschlossen werden sollen. Unterstützte Werte:

  • i: Websitecontent einschließen

  • e: Inhalte von der Website ausschließen
queries.request[].exactTerms

string

Kennzeichnet eine Wortgruppe, die alle Dokumente in den Suchergebnissen enthalten müssen.
queries.request[].excludeTerms

string

Kennzeichnet ein Wort oder eine Wortgruppe, das bzw. die in keinem Dokument in den Suchergebnissen angezeigt werden soll.
queries.request[].linkSite

string

Gibt an, dass alle Ergebnisse einen Link zu einer bestimmten URL enthalten sollen.
queries.request[].orTerms

string

Liefert zusätzliche Suchbegriffe, nach denen in einem Dokument gesucht werden soll, wobei jedes Dokument in den Suchergebnissen mindestens einen der zusätzlichen Suchbegriffe enthalten muss. Für diese Art von Abfrage können Sie auch den Suchbegriff Boolescher Operator OR verwenden.
queries.request[].relatedSite

string

Gibt an, dass alle Suchergebnisse Seiten sein sollen, die sich auf die angegebene URL beziehen. Der Parameterwert muss eine URL sein.
queries.request[].dateRestrict

string

Beschränkt die Ergebnisse auf URLs basierend auf dem Datum. Unterstützte Werte sind:

  • d[number]: Fordert Ergebnisse für die angegebene Anzahl der letzten Tage an.

  • w[number]: Fordert Ergebnisse für die angegebene Anzahl der letzten Wochen an.

  • m[number]: Fordert Ergebnisse für die angegebene Anzahl der letzten Monate an.

  • y[number]: Fordert Ergebnisse für die angegebene Anzahl vergangener Jahre an.
queries.request[].lowRange

string

Gibt den Startwert für einen Suchbereich an. Verwende cse:lowRange und cse:highrange, um einen inklusiven Suchbereich von lowRange...highRange an die Abfrage anzuhängen.
queries.request[].highRange

string

Gibt den Endwert für einen Suchbereich an. Verwende cse:lowRange und cse:highrange, um einen inklusiven Suchbereich von lowRange...highRange an die Abfrage anzuhängen.
queries.request[].fileType

string

Beschränkt die Ergebnisse auf Dateien mit einer bestimmten Erweiterung. Google unterstützt u. a. die folgenden Dateitypen:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • MacWrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Rich-Text-Format (rtf)

  • Shockwave-Blitz (swf)

  • Text (ans, txt).

In Zukunft werden möglicherweise weitere Dateitypen hinzugefügt. Eine aktuelle Liste finden Sie immer in den häufig gestellten Fragen zu Dateitypen von Google.
queries.request[].rights

string

Filter sind lizenzbasiert. Unterstützte Werte sind:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.request[].searchType

string

Zulässige Werte sind web und image. Wenn keine Vorgabe erfolgt, werden die Ergebnisse auf Webseiten beschränkt.
queries.request[].imgSize

string

Beschränkt die Ergebnisse auf Bilder einer bestimmten Größe. Unterstützte Werte:

  • icon (klein)

  • small | medium | large | xlarge (mittel)

  • xxlarge (groß)

  • huge (extragroß)
queries.request[].imgType

string

Beschränkt die Ergebnisse auf Images eines bestimmten Typs. Unterstützte Werte:

  • clipart (Clip)

  • face (Gesicht)

  • lineart (Linienzeichnung)

  • photo (Foto)

  • animated (animiert)

  • stock (Aktie)
queries.request[].imgColorType

string

Beschränkt die Ergebnisse auf Bilder eines bestimmten Farbtyps. Unterstützte Werte:

  • mono (Schwarz-Weiß)

  • gray (Graustufen)

  • color (Farbe)
queries.request[].imgDominantColor

string

Beschränkt die Ergebnisse auf Bilder mit einer bestimmten dominanten Farbe. Unterstützte Werte:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
queries.nextPage[]

object

Metadaten, die gegebenenfalls die nächste Ergebnisseite darstellen.
queries.nextPage[].title

string

Eine Beschreibung der Abfrage.
queries.nextPage[].totalResults

string (int64 format)

Geschätzte Gesamtzahl der Suchergebnisse. Sind möglicherweise nicht genau.
queries.nextPage[].searchTerms

string

Vom Nutzer eingegebene Suchbegriffe
queries.nextPage[].count

integer

Anzahl der in diesem Satz zurückgegebenen Suchergebnisse.
queries.nextPage[].startIndex

integer

Der Index der aktuellen Gruppe von Suchergebnissen in der gesamten Gruppe von Ergebnissen, wobei der Index des ersten Ergebnisses 1 ist.
queries.nextPage[].startPage

integer

Die Seitenzahl dieser Gruppe von Ergebnissen, wobei die Seitenlänge durch das Attribut count festgelegt wird.
queries.nextPage[].language

string

Die Sprache der Suchergebnisse.
queries.nextPage[].inputEncoding

string

Die für Suchanfragen unterstützte Zeichencodierung.
queries.nextPage[].outputEncoding

string

Die für Suchergebnisse unterstützte Zeichencodierung.
queries.nextPage[].safe

string

Legt die SafeSearch-Ebene fest, die zum Herausfiltern nicht jugendfreier Ergebnisse verwendet wird. Dies ist eine benutzerdefinierte Eigenschaft, die nicht in der OpenSearch-Spezifikation definiert ist. Gültige Parameterwerte sind:

  • "off": SafeSearch deaktivieren

  • "active": SafeSearch aktivieren
queries.nextPage[].cx

string

Die Kennung einer Suchmaschine, die mit dem Steuerfeld der Programmable Search Engine erstellt wurde. Dies ist eine benutzerdefinierte Eigenschaft, die in der OpenSearch-Spezifikation nicht definiert ist. Dieser Parameter ist erforderlich.
queries.nextPage[].sort

string

Gibt an, dass Ergebnisse gemäß dem angegebenen Ausdruck sortiert werden sollen. Sortieren Sie beispielsweise nach Datum.
queries.nextPage[].filter

string

Aktiviert oder deaktiviert die automatische Filterung von Google-Suchergebnissen Weitere Informationen zu den Suchergebnisfiltern von Google finden Sie unter Automatische Filterung. Gültige Werte für diesen Parameter sind:

  • 0: deaktiviert

  • 1: Aktiviert (Standardeinstellung)

Hinweis: Standardmäßig wendet Google Filter auf alle Suchergebnisse an, um die Qualität dieser Ergebnisse zu verbessern.
queries.nextPage[].gl

string

Steigt Suchergebnisse, deren Herkunftsland mit dem Parameterwert übereinstimmt. Eine Liste der gültigen Werte finden Sie unter Ländercodes.

Die Angabe eines gl-Parameterwerts in WebSearch-Anfragen sollte die Relevanz der Ergebnisse verbessern. Dies gilt insbesondere für internationale Kunden und insbesondere für Kunden in englischsprachigen Ländern außer den USA.
queries.nextPage[].cr

string

Beschränkt die Suchergebnisse auf Dokumente aus einem bestimmten Land. Sie können im Wert des Parameters cr Boolesche Operatoren verwenden.

Google WebSearch ermittelt das Land eines Dokuments anhand der folgenden Daten:

  • Top-Level-Domain (TLD) der Dokument-URL.

  • Der geografische Standort der IP-Adresse des Webservers.

Eine Liste der gültigen Werte für diesen Parameter finden Sie unter Länderparameterwerte (cr).
queries.nextPage[].googleHost

string

Gibt die Google-Domain an, auf die die Suche beschränkt werden soll, z. B. google.com, google.de oder google.fr.
queries.nextPage[].disableCnTwTranslation

string

Aktiviert oder deaktiviert die Funktion Chinesisch (vereinfacht und traditionell).

Unterstützte Werte:

  • 0: aktiviert (Standardeinstellung)

  • 1: deaktiviert
queries.nextPage[].hq

string

Hängt die angegebenen Suchbegriffe so an die Abfrage an, als wären sie mit einem logischen AND-Operator kombiniert.
queries.nextPage[].hl

string

Gibt die Sprache der Benutzeroberfläche (Hostsprache) Ihrer Benutzeroberfläche an. Wenn Sie diesen Parameter explizit festlegen, werden die Leistung und die Qualität Ihrer Suchergebnisse verbessert.

Weitere Informationen finden Sie im Abschnitt Schnittstellensprachen der Präsentation zur Internationalisierung von Abfragen und Ergebnissen und unter Unterstützte Schnittstellensprachen finden Sie eine Liste der unterstützten Sprachen.
queries.nextPage[].siteSearch

string

Beschränkt die Ergebnisse auf URLs von einer bestimmten Website.
queries.nextPage[].siteSearchFilter

string

Gibt an, ob Ergebnisse von der im sitesearch-Parameter genannten Website ein- oder ausgeschlossen werden sollen. Unterstützte Werte:

  • i: Websitecontent einschließen

  • e: Inhalte von der Website ausschließen
queries.nextPage[].exactTerms

string

Kennzeichnet eine Wortgruppe, die alle Dokumente in den Suchergebnissen enthalten müssen.
queries.nextPage[].excludeTerms

string

Kennzeichnet ein Wort oder eine Wortgruppe, das bzw. die in keinem Dokument in den Suchergebnissen angezeigt werden soll.
queries.nextPage[].linkSite

string

Gibt an, dass alle Ergebnisse einen Link zu einer bestimmten URL enthalten sollen.
queries.nextPage[].orTerms

string

Liefert zusätzliche Suchbegriffe, nach denen in einem Dokument gesucht werden soll, wobei jedes Dokument in den Suchergebnissen mindestens einen der zusätzlichen Suchbegriffe enthalten muss. Für diese Art von Abfrage können Sie auch den Suchbegriff Boolescher Operator OR verwenden.
queries.nextPage[].relatedSite

string

Gibt an, dass alle Suchergebnisse Seiten sein sollen, die sich auf die angegebene URL beziehen. Der Parameterwert muss eine URL sein.
queries.nextPage[].dateRestrict

string

Beschränkt die Ergebnisse auf URLs basierend auf dem Datum. Unterstützte Werte sind:

  • d[number]: Fordert Ergebnisse für die angegebene Anzahl der letzten Tage an.

  • w[number]: Fordert Ergebnisse für die angegebene Anzahl der letzten Wochen an.

  • m[number]: Fordert Ergebnisse für die angegebene Anzahl der letzten Monate an.

  • y[number]: Fordert Ergebnisse für die angegebene Anzahl vergangener Jahre an.
queries.nextPage[].lowRange

string

Gibt den Startwert für einen Suchbereich an. Verwende cse:lowRange und cse:highrange, um einen inklusiven Suchbereich von lowRange...highRange an die Abfrage anzuhängen.
queries.nextPage[].highRange

string

Gibt den Endwert für einen Suchbereich an. Verwende cse:lowRange und cse:highrange, um einen inklusiven Suchbereich von lowRange...highRange an die Abfrage anzuhängen.
queries.nextPage[].fileType

string

Beschränkt die Ergebnisse auf Dateien mit einer bestimmten Erweiterung. Google unterstützt u. a. die folgenden Dateitypen:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • MacWrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Rich-Text-Format (rtf)

  • Shockwave-Blitz (swf)

  • Text (ans, txt).

In Zukunft werden möglicherweise weitere Dateitypen hinzugefügt. Eine aktuelle Liste finden Sie immer in den häufig gestellten Fragen zu Dateitypen von Google.
queries.nextPage[].rights

string

Filter sind lizenzbasiert. Unterstützte Werte sind:

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.nextPage[].searchType

string

Zulässige Werte sind web und image. Wenn keine Vorgabe erfolgt, werden die Ergebnisse auf Webseiten beschränkt.
queries.nextPage[].imgSize

string

Beschränkt die Ergebnisse auf Bilder einer bestimmten Größe. Unterstützte Werte:

  • icon (klein)

  • small | medium | large | xlarge (mittel)

  • xxlarge (groß)

  • huge (extragroß)
queries.nextPage[].imgType

string

Beschränkt die Ergebnisse auf Images eines bestimmten Typs. Unterstützte Werte:

  • clipart (Clip)

  • face (Gesicht)

  • lineart (Linienzeichnung)

  • photo (Foto)

  • animated (animiert)

  • stock (Aktie)
queries.nextPage[].imgColorType

string

Beschränkt die Ergebnisse auf Bilder eines bestimmten Farbtyps. Unterstützte Werte:

  • mono (Schwarz-Weiß)

  • gray (Graustufen)

  • color (Farbe)
queries.nextPage[].imgDominantColor

string

Beschränkt die Ergebnisse auf Bilder mit einer bestimmten dominanten Farbe. Unterstützte Werte:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
promotions[]

object (Promotion)

Die Gruppe von Angeboten. Ist nur vorhanden, wenn die Konfigurationsdateien der benutzerdefinierten Suchmaschine bevorzugte Suchergebnisse für die angegebene Suchanfrage definieren.
context

object (Struct format)

Metadaten und Suchfilter, die mit der jeweiligen Suchmaschine verknüpft sind, einschließlich:

  • Der Name der Suchmaschine, die für die Suchanfrage verwendet wurde.

  • Eine Reihe von Facettenobjekten (Optimierungen), die Sie zum Verfeinern einer Suche verwenden können.
searchInformation

object

Metadaten zu dieser Suche, einschließlich Suchdauer und Gesamtergebnisse
searchInformation.searchTime

number

Die Zeit, die der Server benötigt, um Suchergebnisse zurückzugeben.
searchInformation.formattedSearchTime

string

Die Zeit, die der Server benötigt, um Suchergebnisse zurückzugeben, im Format des Gebietsschemas.
searchInformation.totalResults

string

Die Gesamtzahl der von der Suchanfrage zurückgegebenen Suchergebnisse.
searchInformation.formattedTotalResults

string

Die Gesamtzahl der Suchergebnisse, entsprechend dem Gebietsschemastil formatiert.
spelling

object

Kapselt eine korrigierte Abfrage ein.
spelling.correctedQuery

string

Die korrigierte Abfrage.
spelling.htmlCorrectedQuery

string

Die korrigierte Abfrage im HTML-Format.
items[]

object (Result)

Die aktuellen Ergebnisse der benutzerdefinierten Suche.

Werbung

Ergebnis der Werbeaktion.

JSON-Darstellung 
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
Felder
title

string

Der Titel des Angebots.
htmlTitle

string

Der Titel des Angebots in HTML.
bodyLines[]

object

Ein Array von Blockobjekten für diese Werbeaktion.
bodyLines[].title

string

Der Text des Blockobjekts, falls er Text enthält.
bodyLines[].htmlTitle

string

Der Text des Blockobjekts in HTML, falls es Text enthält.
bodyLines[].url

string

Die URL des Links für das Blockobjekt, falls vorhanden.
bodyLines[].link

string

Der Ankertext des Links des Blockobjekts, falls er über einen Link verfügt.
image

object

Mit diesem Angebot verknüpftes Bild, falls vorhanden.
image.source

string

URL des Bildes für diesen Angebotslink.
image.width

integer

Bildbreite in Pixeln.
image.height

integer

Bildhöhe in Pixeln.

Ergebnis

Ein benutzerdefiniertes Suchergebnis.

JSON-Darstellung 
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
Felder
kind

string

Eine eindeutige Kennung für den Typ des aktuellen Objekts. Für diese API ist das customsearch#result.
title

string

Titel des Suchergebnisses im Nur-Text-Format.
htmlTitle

string

Der Titel des Suchergebnisses in HTML.
snippet

string

Das Snippet des Suchergebnisses im Nur-Text-Format.
htmlSnippet

string

Das Snippet des Suchergebnisses in HTML.
cacheId

string

Gibt die ID der bei Google im Cache gespeicherten Version des Suchergebnisses an.
formattedUrl

string

Die URL, die nach dem Snippet für jedes Suchergebnis angezeigt wird.
htmlFormattedUrl

string

Die URL im HTML-Format, die nach dem Snippet für jedes Suchergebnis angezeigt wird.
pagemap

object (Struct format)

Enthält PageMap-Informationen für dieses Suchergebnis.
mime

string

Der MIME-Typ des Suchergebnisses.
fileFormat

string

Das Dateiformat des Suchergebnisses.
image

object

Zusammenfassung aller Informationen zu einem Bild, das in den Suchergebnissen zurückgegeben wird.
image.contextLink

string

Eine URL, die auf die Webseite verweist, auf der das Bild gehostet wird.
image.height

integer

Die Höhe des Bildes in Pixeln.
image.width

integer

Die Breite des Bildes in Pixeln.
image.byteSize

integer

Die Größe des Bildes in Byte.
image.thumbnailLink

string

Eine URL zur Miniaturansicht.
image.thumbnailHeight

integer

Höhe des Thumbnail-Bilds in Pixeln
image.thumbnailWidth

integer

Die Breite der Miniaturansicht in Pixeln.
labels[]

object

Enthält alle Informationen zu Labels für Suchfilter.
labels[].name

string

Der Name eines Labels zur Verfeinerung, mit dem Sie die Suche eingrenzen können. Zeigen Sie dies nicht auf Ihrer Benutzeroberfläche an, sondern verwenden Sie stattdessen displayName.
labels[].displayName

string

Der Anzeigename eines Suchfilter-Labels. Dies ist der Name, der auf Ihrer Benutzeroberfläche angezeigt werden soll.
labels[].label_with_op

string

Suchfilter-Label und zugehöriger Optimierungsvorgang.