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 das „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 Satzmetadaten, die nach Rollennamen benannt sind. Zu den möglichen Rollennamen gehören request (definiert durch die OpenSearch-Abfragerollen) und zwei benutzerdefinierte Rollen: nextPage und previousPage.

queries.previousPage[]

object

Metadaten zur vorherigen Ergebnisseite, falls zutreffend.

queries.previousPage[].title

string

Eine Beschreibung der Abfrage.

queries.previousPage[].totalResults

string (int64 format)

Geschätzte Anzahl der Suchergebnisse insgesamt. Stimmt möglicherweise nicht.

queries.previousPage[].searchTerms

string

Die vom Nutzer eingegebenen Suchbegriffe.

queries.previousPage[].count

integer

Anzahl der in dieser Gruppe zurückgegebenen Suchergebnisse.

queries.previousPage[].startIndex

integer

Der Index der aktuellen Gruppe von Suchergebnissen in der Gesamtmenge der Ergebnisse, wobei der Index des ersten Ergebnisses 1 ist.

queries.previousPage[].startPage

integer

Die Seitenzahl dieser Gruppe von Ergebnissen, wobei die Seitenlänge durch die Property 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

Gibt die SafeSearch-Stufe an, 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 ID einer Suchmaschine, die mit dem Steuerfeld der Programmable Search Engine erstellt wurde. Dies ist eine benutzerdefinierte Eigenschaft, die nicht in der OpenSearch-Spezifikation definiert ist. Dieser Parameter ist erforderlich.

queries.previousPage[].sort

string

Gibt an, dass die Ergebnisse gemäß dem angegebenen Ausdruck sortiert werden sollen. Sie können zum Beispiel nach Datum sortieren.

queries.previousPage[].filter

string

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

  • 0: Deaktiviert

  • 1: Aktiviert (Standardeinstellung)

Hinweis: Standardmäßig filtert Google alle Suchergebnisse, um deren Qualität zu verbessern.

queries.previousPage[].gl

string

Verbessert Suchergebnisse, deren Ursprungsland 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 Boolesche Operatoren im Wert des Parameters cr verwenden.

Google WebSearch ermittelt das Land eines Dokuments anhand folgender Daten:

  • Die 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 Werte für Länderparameter (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 Suchfunktion für Vereinfachtes und traditionelles Chinesisch.

Unterstützte Werte:

  • 0: aktiviert (Standardeinstellung)

  • 1: deaktiviert

queries.previousPage[].hq

string

Hängt die angegebenen Suchbegriffe an die Abfrage an, als wären sie mit einem logischen AND-Operator kombiniert.

queries.previousPage[].hl

string

Legt die Sprache der Benutzeroberfläche (Hostsprache) für Ihre Benutzeroberfläche fest. Durch das explizite Festlegen dieses Parameters wird die Leistung und Qualität Ihrer Suchergebnisse verbessert.

Weitere Informationen finden Sie im Abschnitt Interface Languages (Schnittstellensprachen) des Artikels Abfragen und Ergebnispräsentationen internationalisieren. Eine Liste der unterstützten Sprachen finden Sie unter Unterstützte Oberflächensprachen.

queries.previousPage[].siteSearch

string

Beschränkt die Ergebnisse auf URLs einer bestimmten Website.

queries.previousPage[].siteSearchFilter

string

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

  • i: Inhalte der Website einschließen

  • e: Inhalte von der Website ausschließen

queries.previousPage[].exactTerms

string

Gibt eine Wortgruppe an, die alle Dokumente in den Suchergebnissen enthalten müssen.

queries.previousPage[].excludeTerms

string

Bezeichnet ein Wort oder eine Wortgruppe, das bzw. die in den Suchergebnissen nicht in Dokumenten erscheinen soll.

queries.previousPage[].linkSite

string

Gibt an, dass alle Ergebnisse einen Link zu einer bestimmten URL enthalten sollen.

queries.previousPage[].orTerms

string

Stellt zusätzliche Suchbegriffe bereit, nach denen in einem Dokument gesucht werden soll, wobei jedes Dokument in den Suchergebnissen mindestens einen der zusätzlichen Suchbegriffe enthalten muss. Sie können für diese Art von Abfrage auch den Booleschen OR-Suchbegriff verwenden.

queries.previousPage[].relatedSite

string

Gibt an, dass alle Suchergebnisse Seiten sein sollen, die zur angegebenen URL gehören. Der Parameterwert muss eine URL sein.

queries.previousPage[].dateRestrict

string

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

  • d[number]: Fordert Ergebnisse der angegebenen Anzahl von vergangenen Tagen an.

  • w[number]: Fordert Ergebnisse 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 der vergangenen Jahre an.

queries.previousPage[].lowRange

string

Gibt den Startwert für einen Suchbereich an. Verwenden Sie cse:lowRange und cse:highrange, um einen Suchbereich von lowRange...highRange an die Abfrage anzuhängen.

queries.previousPage[].highRange

string

Gibt den Endwert für einen Suchbereich an. Verwenden Sie cse:lowRange und cse:highrange, um einen 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 unter anderem folgende Dateitypen:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

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

  • Lotus WordPro (lwp)

  • Mac-Write (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • RTF-Format (rtf)

  • Shockwave Flash (swf)

  • SMS (ans, txt)

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

queries.previousPage[].rights

string

Lizenzbasierte Filter. 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 kein Wert angegeben ist, 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 Bilder eines bestimmten Typs. Unterstützte Werte:

  • clipart (Clip-Art)

  • 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 sind:

  • 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 zur aktuellen Anfrage.

queries.request[].title

string

Eine Beschreibung der Abfrage.

queries.request[].totalResults

string (int64 format)

Geschätzte Anzahl der Suchergebnisse insgesamt. Stimmt möglicherweise nicht.

queries.request[].searchTerms

string

Die vom Nutzer eingegebenen Suchbegriffe.

queries.request[].count

integer

Anzahl der in dieser Gruppe zurückgegebenen Suchergebnisse.

queries.request[].startIndex

integer

Der Index der aktuellen Gruppe von Suchergebnissen in der Gesamtmenge der Ergebnisse, wobei der Index des ersten Ergebnisses 1 ist.

queries.request[].startPage

integer

Die Seitenzahl dieser Gruppe von Ergebnissen, wobei die Seitenlänge durch die Property 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

Gibt die SafeSearch-Stufe an, 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 ID einer Suchmaschine, die mit dem Steuerfeld der Programmable Search Engine erstellt wurde. Dies ist eine benutzerdefinierte Eigenschaft, die nicht in der OpenSearch-Spezifikation definiert ist. Dieser Parameter ist erforderlich.

queries.request[].sort

string

Gibt an, dass die Ergebnisse gemäß dem angegebenen Ausdruck sortiert werden sollen. Sie können zum Beispiel nach Datum sortieren.

queries.request[].filter

string

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

  • 0: Deaktiviert

  • 1: Aktiviert (Standardeinstellung)

Hinweis: Standardmäßig filtert Google alle Suchergebnisse, um deren Qualität zu verbessern.

queries.request[].gl

string

Verbessert Suchergebnisse, deren Ursprungsland 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 Boolesche Operatoren im Wert des Parameters cr verwenden.

Google WebSearch ermittelt das Land eines Dokuments anhand folgender Daten:

  • Die 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 Werte für Länderparameter (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 Suchfunktion für Vereinfachtes und traditionelles Chinesisch.

Unterstützte Werte:

  • 0: aktiviert (Standardeinstellung)

  • 1: deaktiviert

queries.request[].hq

string

Hängt die angegebenen Suchbegriffe an die Abfrage an, als wären sie mit einem logischen AND-Operator kombiniert.

queries.request[].hl

string

Legt die Sprache der Benutzeroberfläche (Hostsprache) für Ihre Benutzeroberfläche fest. Durch das explizite Festlegen dieses Parameters wird die Leistung und Qualität Ihrer Suchergebnisse verbessert.

Weitere Informationen finden Sie im Abschnitt Interface Languages (Schnittstellensprachen) des Artikels Abfragen und Ergebnispräsentationen internationalisieren. Eine Liste der unterstützten Sprachen finden Sie unter Unterstützte Oberflächensprachen.

queries.request[].siteSearch

string

Beschränkt die Ergebnisse auf URLs einer bestimmten Website.

queries.request[].siteSearchFilter

string

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

  • i: Inhalte der Website einschließen

  • e: Inhalte von der Website ausschließen

queries.request[].exactTerms

string

Gibt eine Wortgruppe an, die alle Dokumente in den Suchergebnissen enthalten müssen.

queries.request[].excludeTerms

string

Bezeichnet ein Wort oder eine Wortgruppe, das bzw. die in den Suchergebnissen nicht in Dokumenten erscheinen soll.

queries.request[].linkSite

string

Gibt an, dass alle Ergebnisse einen Link zu einer bestimmten URL enthalten sollen.

queries.request[].orTerms

string

Stellt zusätzliche Suchbegriffe bereit, nach denen in einem Dokument gesucht werden soll, wobei jedes Dokument in den Suchergebnissen mindestens einen der zusätzlichen Suchbegriffe enthalten muss. Sie können für diese Art von Abfrage auch den Booleschen OR-Suchbegriff verwenden.

queries.request[].relatedSite

string

Gibt an, dass alle Suchergebnisse Seiten sein sollen, die zur angegebenen URL gehören. Der Parameterwert muss eine URL sein.

queries.request[].dateRestrict

string

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

  • d[number]: Fordert Ergebnisse der angegebenen Anzahl von vergangenen Tagen an.

  • w[number]: Fordert Ergebnisse 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 der vergangenen Jahre an.

queries.request[].lowRange

string

Gibt den Startwert für einen Suchbereich an. Verwenden Sie cse:lowRange und cse:highrange, um einen Suchbereich von lowRange...highRange an die Abfrage anzuhängen.

queries.request[].highRange

string

Gibt den Endwert für einen Suchbereich an. Verwenden Sie cse:lowRange und cse:highrange, um einen 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 unter anderem folgende Dateitypen:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

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

  • Lotus WordPro (lwp)

  • Mac-Write (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • RTF-Format (rtf)

  • Shockwave Flash (swf)

  • SMS (ans, txt)

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

queries.request[].rights

string

Lizenzbasierte Filter. 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 kein Wert angegeben ist, 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 Bilder eines bestimmten Typs. Unterstützte Werte:

  • clipart (Clip-Art)

  • 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 sind:

  • 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 die nächste Ergebnisseite darstellen, falls zutreffend.

queries.nextPage[].title

string

Eine Beschreibung der Abfrage.

queries.nextPage[].totalResults

string (int64 format)

Geschätzte Anzahl der Suchergebnisse insgesamt. Stimmt möglicherweise nicht.

queries.nextPage[].searchTerms

string

Die vom Nutzer eingegebenen Suchbegriffe.

queries.nextPage[].count

integer

Anzahl der in dieser Gruppe zurückgegebenen Suchergebnisse.

queries.nextPage[].startIndex

integer

Der Index der aktuellen Gruppe von Suchergebnissen in der Gesamtmenge der Ergebnisse, wobei der Index des ersten Ergebnisses 1 ist.

queries.nextPage[].startPage

integer

Die Seitenzahl dieser Gruppe von Ergebnissen, wobei die Seitenlänge durch die Property 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

Gibt die SafeSearch-Stufe an, 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 ID einer Suchmaschine, die mit dem Steuerfeld der Programmable Search Engine erstellt wurde. Dies ist eine benutzerdefinierte Eigenschaft, die nicht in der OpenSearch-Spezifikation definiert ist. Dieser Parameter ist erforderlich.

queries.nextPage[].sort

string

Gibt an, dass die Ergebnisse gemäß dem angegebenen Ausdruck sortiert werden sollen. Sie können zum Beispiel nach Datum sortieren.

queries.nextPage[].filter

string

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

  • 0: Deaktiviert

  • 1: Aktiviert (Standardeinstellung)

Hinweis: Standardmäßig filtert Google alle Suchergebnisse, um deren Qualität zu verbessern.

queries.nextPage[].gl

string

Verbessert Suchergebnisse, deren Ursprungsland 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 Boolesche Operatoren im Wert des Parameters cr verwenden.

Google WebSearch ermittelt das Land eines Dokuments anhand folgender Daten:

  • Die 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 Werte für Länderparameter (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 Suchfunktion für Vereinfachtes und traditionelles Chinesisch.

Unterstützte Werte:

  • 0: aktiviert (Standardeinstellung)

  • 1: deaktiviert

queries.nextPage[].hq

string

Hängt die angegebenen Suchbegriffe an die Abfrage an, als wären sie mit einem logischen AND-Operator kombiniert.

queries.nextPage[].hl

string

Legt die Sprache der Benutzeroberfläche (Hostsprache) für Ihre Benutzeroberfläche fest. Durch das explizite Festlegen dieses Parameters wird die Leistung und Qualität Ihrer Suchergebnisse verbessert.

Weitere Informationen finden Sie im Abschnitt Interface Languages (Schnittstellensprachen) des Artikels Abfragen und Ergebnispräsentationen internationalisieren. Eine Liste der unterstützten Sprachen finden Sie unter Unterstützte Oberflächensprachen.

queries.nextPage[].siteSearch

string

Beschränkt die Ergebnisse auf URLs einer bestimmten Website.

queries.nextPage[].siteSearchFilter

string

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

  • i: Inhalte der Website einschließen

  • e: Inhalte von der Website ausschließen

queries.nextPage[].exactTerms

string

Gibt eine Wortgruppe an, die alle Dokumente in den Suchergebnissen enthalten müssen.

queries.nextPage[].excludeTerms

string

Bezeichnet ein Wort oder eine Wortgruppe, das bzw. die in den Suchergebnissen nicht in Dokumenten erscheinen soll.

queries.nextPage[].linkSite

string

Gibt an, dass alle Ergebnisse einen Link zu einer bestimmten URL enthalten sollen.

queries.nextPage[].orTerms

string

Stellt zusätzliche Suchbegriffe bereit, nach denen in einem Dokument gesucht werden soll, wobei jedes Dokument in den Suchergebnissen mindestens einen der zusätzlichen Suchbegriffe enthalten muss. Sie können für diese Art von Abfrage auch den Booleschen OR-Suchbegriff verwenden.

queries.nextPage[].relatedSite

string

Gibt an, dass alle Suchergebnisse Seiten sein sollen, die zur angegebenen URL gehören. Der Parameterwert muss eine URL sein.

queries.nextPage[].dateRestrict

string

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

  • d[number]: Fordert Ergebnisse der angegebenen Anzahl von vergangenen Tagen an.

  • w[number]: Fordert Ergebnisse 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 der vergangenen Jahre an.

queries.nextPage[].lowRange

string

Gibt den Startwert für einen Suchbereich an. Verwenden Sie cse:lowRange und cse:highrange, um einen Suchbereich von lowRange...highRange an die Abfrage anzuhängen.

queries.nextPage[].highRange

string

Gibt den Endwert für einen Suchbereich an. Verwenden Sie cse:lowRange und cse:highrange, um einen 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 unter anderem folgende Dateitypen:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

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

  • Lotus WordPro (lwp)

  • Mac-Write (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • RTF-Format (rtf)

  • Shockwave Flash (swf)

  • SMS (ans, txt)

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

queries.nextPage[].rights

string

Lizenzbasierte Filter. 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 kein Wert angegeben ist, 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 Bilder eines bestimmten Typs. Unterstützte Werte:

  • clipart (Clip-Art)

  • 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 sind:

  • 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 der Angebote. Nur vorhanden, wenn in den Konfigurationsdateien der benutzerdefinierten Suchmaschine bevorzugte Suchergebnisse für die jeweilige Suchanfrage definiert sind.

context

object (Struct format)

Mit der jeweiligen Suchmaschine verknüpfte Metadaten und Suchfilter, 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 hat, um Suchergebnisse zurückzugeben.

searchInformation.formattedSearchTime

string

Zeit, die der Server benötigt, um Suchergebnisse zurückzugeben, entsprechend dem Gebietsschema-Stil formatiert.

searchInformation.totalResults

string

Die Gesamtzahl der von der Abfrage zurückgegebenen Suchergebnisse.

searchInformation.formattedTotalResults

string

Die Gesamtzahl der Suchergebnisse, formatiert im Stil des Gebietsschemas.

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.

Angebot

Ergebnis der Aufwertung.

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 im HTML-Format.

bodyLines[]

object

Ein Array von Blockobjekten für diese Werbeaktion.

bodyLines[].title

string

Der Text des Blockobjekts, falls dieser Text enthält.

bodyLines[].htmlTitle

string

Der Text des Blockobjekts in HTML, falls dieser Text enthält.

bodyLines[].url

string

Die URL des Links des Blockierobjekts, falls vorhanden.

bodyLines[].link

string

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

image

object

Mit dieser Werbung 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 es customsearch#result..

title

string

Der Titel des Suchergebnisses im Nur-Text-Format.

htmlTitle

string

Der Titel des Suchergebnisses im HTML-Format.

snippet

string

Das Snippet des Suchergebnisses im Nur-Text-Format.

htmlSnippet

string

Das Snippet des Suchergebnisses im HTML-Code.

cacheId

string

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

formattedUrl

string

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

htmlFormattedUrl

string

Die HTML-formatierte URL, die für jedes Suchergebnis nach dem Snippet 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

Fasst alle Informationen zu einem Bild zusammen, 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 Bilds in Pixeln.

image.byteSize

integer

Die Größe des Bildes in Byte.

image.thumbnailLink

string

Eine URL zur Miniaturansicht.

image.thumbnailHeight

integer

Die Höhe der Miniaturansicht in Pixeln.

image.thumbnailWidth

integer

Die Breite der Miniaturansicht in Pixeln.

labels[]

object

Kapselt alle Informationen zu Suchfilter-Labels.

labels[].name

string

Der Name eines Suchfilter-Labels, mit dem Sie Suchanfragen verfeinern können. Zeigen Sie dies nicht auf Ihrer Benutzeroberfläche an. verwenden Sie stattdessen displayName.

labels[].displayName

string

Der Anzeigename eines Suchfilter-Labels. Dieser Name sollte auf Ihrer Benutzeroberfläche angezeigt werden.

labels[].label_with_op

string

Suchfilter-Label und zugehöriger Suchfiltervorgang.