Gibt Metadaten zur durchgeführten Suche, zur verwendeten Suchmaschine und zu den Suchergebnissen zurück.
HTTP-Anfrage
GET https://customsearch.googleapis.com/customsearch/v1
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter | |
---|---|
c2coff |
Aktiviert oder deaktiviert die Suche in vereinfachtem und traditionellem Chinesisch. Der Standardwert für diesen Parameter ist 0 (null). Dies bedeutet, dass die Funktion aktiviert ist. Unterstützte Werte:
|
cr |
Beschränkt die Suchergebnisse auf Dokumente aus einem bestimmten Land. Sie können im Wert des Parameters „cr“ Boolesche Operatoren verwenden. Das Land eines Dokuments wird in der Google Suche anhand folgender Daten bestimmt:
Auf der Seite Länderparameterwerte finden Sie eine Liste der gültigen Werte für diesen Parameter. |
cx |
Die Programmable Search Engine-ID, die für diese Anfrage verwendet werden soll. |
dateRestrict |
Beschränkt die Ergebnisse auf URLs basierend auf dem Datum. Unterstützte Werte sind:
|
exactTerms |
Kennzeichnet eine Wortgruppe, die alle Dokumente in den Suchergebnissen enthalten müssen. |
excludeTerms |
Kennzeichnet ein Wort oder eine Wortgruppe, das bzw. die in keinem Dokument in den Suchergebnissen angezeigt werden soll. |
fileType |
Beschränkt die Ergebnisse auf Dateien mit einer bestimmten Erweiterung. Eine Liste der Dateitypen, die von Google indexiert werden können, finden Sie in der Search Console-Hilfe. |
filter |
Hiermit können Sie festlegen, ob der Filter für duplizierte Inhalte aktiviert oder deaktiviert werden soll.
Akzeptable Werte sind:
|
gl |
Standortbestimmung des Endnutzers.
|
googlehost |
Verworfen. Verwenden Sie den Parameter Die lokale Google-Domain (z. B. google.com, google.de oder google.fr), die für die Suche verwendet werden soll. |
highRange |
Gibt den Endwert für einen Suchbereich an.
|
hl |
Legt die Sprache der Benutzeroberfläche fest.
|
hq |
Hängt die angegebenen Suchbegriffe so an die Abfrage an, als wären sie mit einem logischen UND-Operator kombiniert worden. |
imgColorType |
Gibt Schwarz-Weiß-, Graustufen-, transparente oder farbige Bilder zurück. Akzeptable Werte sind:
|
imgDominantColor |
Gibt Bilder einer bestimmten dominanten Farbe zurück. Akzeptable Werte sind:
|
imgSize |
Gibt Bilder einer bestimmten Größe zurück. Akzeptable Werte sind:
|
imgType |
Gibt Bilder eines bestimmten Typs zurück. Akzeptable Werte sind:
|
linkSite |
Gibt an, dass alle Suchergebnisse einen Link zu einer bestimmten URL enthalten sollen. |
lowRange |
Gibt den Startwert für einen Suchbereich an. Verwende |
lr |
Beschränkt die Suche auf Dokumente in einer bestimmten Sprache (z.B. Akzeptable Werte sind:
|
num |
Anzahl der zurückzugebenden Suchergebnisse.
|
orTerms |
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. |
q |
Abfrage |
relatedSite |
Veraltet. |
rights |
Filter sind lizenzbasiert. Unterstützte Werte sind: |
safe |
Sicherheitsebene für Suche. Akzeptable Werte sind:
|
searchType |
Gibt den Suchtyp an: Akzeptable Werte sind:
|
siteSearch |
Gibt eine bestimmte Website an, die immer ein- oder ausgeschlossen werden soll (siehe |
siteSearchFilter |
Steuert, ob Ergebnisse der im Akzeptable Werte sind:
|
sort |
Der Sortierausdruck, der auf die Ergebnisse angewendet werden soll. Der Parameter sort gibt an, dass die Ergebnisse nach dem angegebenen Ausdruck sortiert werden sollen, d.h. nach Datum. Beispiel: sort=date. |
start |
Index des ersten zurückzugebenden Ergebnisses Die Standardanzahl der Ergebnisse pro Seite ist 10, sodass |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Search
.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/cse
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.