XML API-Referenzanhänge

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Boolesche Operatoren

In den folgenden Parametern können boolesche Werte in Werten verwendet werden:

Boolesche Operatordefinitionen

Hinweis:In Parameterwerten können keine Leerzeichen enthalten sein.

Boolesch AND [.]
Beschreibung

Der Operator AND (.) gibt Ergebnisse zurück, die sich in der Schnittmenge der Sammlungen auf einer der beiden Seiten des Operators „.“ befinden.

Beispiele

In diesem Beispiel werden alle Ergebnisse auf Französisch oder Italienisch entfernt:
lr=(-lang_fr).(-lang_it)


Boolescher Wert NOT [-]
Beschreibung

Der Operator NOT (.) entfernt alle Ergebnisse, die sich in der Sammlung befinden, unmittelbar nach dem Minuszeichen („-“).

Beispiele

In diesem Beispiel werden alle Ergebnisse auf Französisch entfernt:
lr=-lang_fr

In diesem Beispiel werden alle Ergebnisse auf Französisch oder Italienisch entfernt:
lr=(-lang_fr).(-lang_it)

Hinweis: Vielleicht hast du schon bemerkt, dass im zweiten Beispiel mit dem Booleschen AND-Operator festgelegt wird, dass die Ergebnisse nicht auf Französisch oder Italienisch geschrieben werden sollen. Abhängig von der Platzierung von Klammern in Ihrer Abfrage können Sie entweder den Booleschen AND-Operator oder den Booleschen OR-Operator verwenden, um diese Abfrage auszudrücken. Der Grund dafür ist, dass ein Dokument auf Französisch nicht auf Italienisch geschrieben ist. Ihre Boolesche Anweisung muss daher ausdrücken, dass das Dokument nicht auf Französisch und das Dokument nicht auf Italienisch geschrieben ist.


Boolesches OR [|]
Beschreibung

Der OR-Operator (.) gibt Ergebnisse zurück, die sich entweder in der Sammlung links oder in der Sammlung rechts vom senkrechten Strich („|“) befinden.

Beispiele

In diesem Beispiel werden alle Ergebnisse zurückgegeben, die in vereinfachtem Chinesisch oder traditionellem Chinesisch geschrieben sind:
lr=lang_zh-TW|lang_zh-CN

In diesem Beispiel werden alle Ergebnisse angefordert, die nicht auf Französisch oder Italienisch geschrieben sind. Beachten Sie, dass Klammern an einer anderen Stelle als die Beispielabfrage für den Operator Boolean AND platziert werden:
lr=-(lang_fr|lang_it)


Boolesche Klammern [()]
Beschreibung

Mit diesem Operator können Sie prüfen, ob alle Begriffe im innersten Satz von Klammern vor den Begriffen außerhalb der Klammern ausgewertet werden. Sie können Klammern verwenden, um die Reihenfolge anzupassen, in der Begriffe entfernt werden.

Beispiele

Das Beispiel für den Operator NOT [-] zeigt das folgende Konstrukt für Anfrageergebnisse, die nicht auf Französisch oder Italienisch geschrieben sind:
lr=(-lang_fr).(-lang_it)

Das Beispiel für den Operator OR (|) zeigt auch eine Anfrage für Ergebnisse, die nicht auf Französisch oder Italienisch geschrieben sind. Da im letzten Beispiel der OR-Operator anstelle des AND-Operators verwendet wird, muss auch die Position der Klammern geändert werden:
lr=-(lang_fr|lang_it)


URL-Escaping

Wenn du eine HTTP-Suchanfrage senden möchtest, musst du bestimmte Konventionen beachten, damit Google deine HTTP-Anfrage richtig übersetzen und eine entsprechende Antwort generieren kann.

Das HTTP-URL-Schema gibt an, dass eine HTTP-URL-Anfrage nur bestimmte Zeichen enthalten darf:

  • Alphanumerische Zeichen: (a-z, A-Z, 0-9)
  • Sonderzeichen: $ - _ . | + !* ' ( )
  • Reservierte Zeichen: ; / ? : @ = &

Google verwendet reservierte Zeichen zum Decodieren von URLs und einige Sonderzeichen zum Anfordern von Suchfunktionen. Daher solltest du alle nicht alphanumerischen Zeichen, die in den Suchparametern vorkommen, mit URL-Escape-Zeichen versehen.

Wenn Sie einen String mit einem URL-Escapezeichen versehen möchten, wandeln Sie jede Sequenz von Leerzeichen in ein einzelnes Pluszeichen (+) um und ersetzen Sie alle nicht alphanumerischen Zeichen durch den Hexadezimalwert des jeweiligen Zeichens. Die Hexadezimalcodes der oben aufgeführten Sonderzeichen und reservierten Zeichen sind in der folgenden Tabelle aufgeführt. Für jedes dieser Zeichen sollte in den Anfrageparameterwerten die URL-Escape-Zeichen verwendet werden.

Figur Hexadezimal
Codierung
$ %24
%2D
_ %5F
. %2E
+ %2 Mrd.
! %21
* %2A
" %22.
' %27
( %28
) %29
; %3 Mrd.
/ %2F.
? %3F
: %3A.
@ %40
= %3D
& %26 %
| %7C

Beispiele

Ursprünglicher String URL-Escape-String
Faustschlag Punch%26judy
O'Reilly Oilly

Zusätzliche Informationen zum URL-Escape-Format erhalten Sie auf den Websites von W3C und IETF.

Ergebnisse komprimieren

Google kann die Suchergebnisse mithilfe der gzip-Komprimierung von HTTP komprimieren. Wenn Sie Inhalte dekomprimieren können, die mit dem gzip-Algorithmus komprimiert wurden, können Sie 50 bis 70 % Bandbreiteneinsparungen erzielen, was Ihre Antwortzeiten verbessern kann.

Wenn du möchtest, dass Google Ergebnisse in einem komprimierten Format zurückgibt, füge deiner HTTP-Suchanfrage den HTTP-Header Accept-Encoding folgendermaßen hinzu:

Accept-Encoding: gzip

Wenn Google die Suchergebnisse mithilfe der gzip-Komprimierung zurückgibt, fügen wir die folgende Zeile in die zurückgegebenen HTTP-Header ein:

Contentcodierung: gzip

Hinweis: Wenn der HTTP-Header Content-Encoding nicht in der Antwort enthalten ist, wurden die Ergebnisse nicht komprimiert.

Dieses Verhalten ist im HTTP-Standard angegeben. Weitere Informationen zur Verwendung der HTTP-gzip-Komprimierung finden Sie in diesem Dokument.

Internationale Werte

Zeichencodierungsschemas

In der folgenden Tabelle sind die von Google unterstützten Zeichencodierungsschemas aufgeführt. Sie können den Werten in den ersten beiden Spalten dieser Tabelle die Parameter ie und oe zuweisen. Die Werte in der ersten Spalte sind Aliasse für die Codierungsschemas. Die Werte in der zweiten Spalte sind die Standardnamen für die Codierungsschemas. Google gibt die Standardnamen in XML-Ergebnissen zurück. Die Standardnamen sind zur Verwendung in den HTTP-Headern Content-type deines Dokuments geeignet.

Google-Name Codierung Verknüpfte unterstützte Sprachen
Western (ISO-8859-1) ISO-8859-1 Westeuropäisch (Deutsch, Dänisch, Englisch, Finnisch, Französisch, Indonesisch, Italienisch, Katalanisch, Niederländisch, Norwegisch, Portugiesisch, Schwedisch)
latin2 ISO-8859-2 Osteuropäisch (Kroatisch, Tschechisch, Ungarisch, Polnisch, Rumänisch, Serbisch, Slowakisch, Slowenisch)
latin3 ISO-8859-3  
latin4 ISO-8859-4 Baltisch (Estnisch, Lettisch, Litauisch)
Kyrillisch ISO-8859-5 Bulgarisch, Russisch
Arabisch ISO-8859-6  
Grieche / Griechin / griechisch / Griechisch ISO-8859-7 Griechisch
Hebräisch ISO-8859-8 Hebräisch
latin5 ISO-8859-9  
latin6 ISO-8859-10 Isländisch
euc-jp EUC-JP Japanisch
euc-kr EUC-KR Koreanisch
sjis Shift_JIS Japanisch
big5 Big5 Chinesisch (traditionell)
gb GB2312 Chinesisch (vereinfacht)
utf8 UTF-8 Alle

Unterstützte Sprachen für die Benutzeroberfläche

Google unterstützt mehr als 80 Sprachen. Die Standardsprache der Benutzeroberfläche ist Englisch. In der folgenden Liste sind alle von Google unterstützten Oberflächensprachen aufgeführt.

Sprache der Benutzeroberfläche hl-Parameterwert
Afrikaans af
Albanisch sq
Amharisch sm
Arabisch ar
Aserbaidschanisch az
Baskisch eu
Belarussisch be
Bengalisch bn
Bihari bh
Bosnisch bs
Bulgarisch bg
Katalanisch ca
Chinesisch (vereinfacht) ZH-CN
Chinesisch (traditionell) zh-TW
Kroatisch Std.
Tschechisch cs
Dänisch da
Niederländisch nl
Englisch en
Esperanto eo
Estnisch et
Färöisch fo
Finnisch fi
Französisch fr
Friesisch fy
Galizisch gl
Georgisch ka
Deutsch de
Griechisch el
Gujarati gu
Hebräisch iw
Hindi hi
Ungarisch hu
Isländisch ist
Indonesisch id
Interlingua ia
Irisch ga
Italienisch it
Japanisch ja
Javanisch jw
Kannada kn
Koreanisch ko
Latin la
Lettisch lv
Litauisch lt
Mazedonisch mk
Malaiisch ms
Malaya ml
Maltesisch mt
Marathi mr
Nepalesisch ne
Norwegisch Nein
Norwegisch (Nynorsk) nn
Okzitanisch oc
Persisch fa
Polnisch pl
Portugiesisch (Brasilien) pt-BR
Portugiesisch (Portugal) pt-PT
Punjabi pa
Rumänisch ro
Russisch ru
Schottisches Gälisch gd
Serbisch sr
Singhalesisch si
Slowakisch sk
Slowenisch sl
Spanisch es
Sudanesisch su
Swahili sw
Schwedisch sv
Tagalog tl
Tamil ta
Telugu te
Thailändisch th
Tigrinya ti
Türkisch tr
Ukrainisch uk
Urdu ur
Usbekisch uz
Vietnamesisch vi
Walisisch cy
Xhosa xh
Zulu zu

Werte für die Sprachsammlung

Mit den folgenden Werten können Sie mit dem Abfrageparameter lr einen Sprachfilter angeben:

Sprache lr-Parameterwert
Arabisch lang_ar
Bulgarisch lang_bg
Katalanisch lang_ca
Chinesisch (vereinfacht) lang_zh-CN
Chinesisch (traditionell) lang_zh-TW
Kroatisch lang_hr
Tschechisch lang_cs
Dänisch Lang
Niederländisch lang_nl
Englisch lang_de
Estnisch lang_et
Finnisch lang_fi
Französisch lang_fr
Deutsch lang_de
Griechisch Lang
Hebräisch lang_iw
Ungarisch lang_hu
Isländisch Lang_ist
Indonesisch lang_id
Italienisch lang_it
Japanisch lang_ja
Koreanisch Lang_Ko
Lettisch lang_lv
Litauisch lang_lt
Norwegisch lang_no
Polnisch lang_pl
Portugiesisch lang_pt
Rumänisch lang_ro
Russisch Lang
Serbisch lang_sr
Slowakisch Lang
Slowenisch lang_sl
Spanisch lang_es
Schwedisch lang_sv
Türkisch lang_tr

Ländersammlungswerte

Mit den folgenden Werten können Sie mithilfe des Suchparameters cr einen Länderfilter angeben:

Land Name der Ländersammlung
Afghanistan Land AF
Albanien Land
Algerien Land DZ
Amerikanisch-Samoa LandAS
Andorra Land AD
Angola LandAO
Anguilla Länder-KI
Antarktis Land AQ
Antigua und Barbuda Land AG
Argentinien countryAR
Armenien Land AM
Aruba Land AW
Australien LandAU
Österreich Land (AT)
Aserbaidschan Land
Bahamas countryBS
Bahrain LandBH
Bangladesch LandBD
Barbados LandBB
Belarus LandBY
Belgien Land BE
Belize LandBZ
Benin LandBJ
Bermuda LandBM
Bhutan LandBT
Bolivien LandBO
Bosnien und Herzegowina LandBA
Botsuana LandBW
Bouvetinsel LandBV
Brasilien LandBR
Britisches Territorium im Indischen Ozean countryIO
Brunei Darussalam LandBN
Bulgarien LandBG
Burkina Faso LandBF
Burundi LandBI
Kambodscha Land KH
Kamerun Land CM
Kanada Land CA
Cabo Verde CV Land
Kaimaninseln LandKY
Zentralafrikanische Republik LandCF
Tschad Land (TD)
Chile countryCL
China LandCN
Weihnachtsinsel LandCX
Kokosinseln (Keelinginseln) Ländercode (countryCC)
Kolumbien Land CO
Komoren CountryKM
Kongo LandCG
Kongo, Demokratische Republik Landes-CD
Cookinseln Land CK
Costa Rica Länder-CR
Côte d'Ivoire countryCI
Kroatien (Hrvatska) LandHR
Kuba Land CU
Zypern LandCY
Tschechien Land CZ
Dänemark Land DK
Dschibuti Country-DJ
Dominica Land-DM
Dominikanische Republik countryDO
Osttimor Land TP
Ecuador Land EC
Ägypten countryEG
El Salvador LandSV
Äquatorialguinea CountryGQ
Eritrea Countryer
Estland LandEE
Äthiopien Land (ET)
Europäische Union Land EU
Falklandinseln Land FK
Färöer countryFO
Fidschi countryFj
Finnland countryFI
Frankreich countryFR
Frankreich, Metropolitan LandFx
Französisch-Guayana Land GF
Französisch-Polynesien LandPF
Französische Südgebiete Land TF
Gabun Land (GA)
Gambia CountryGM
Georgia Land GE
Deutschland Land DE
Ghana LandGH
Gibraltar CountryGI
Griechenland LandGR
Grönland LandGL
Grenada Land GD
Guadeloupe Land/GP
Guam LandGU
Guatemala LandGT
Guinea countryGN
Guinea-Bissau LandGW
Guyana LandGY
Haiti Land
Heard und die McDonaldinseln LandHM
Heiliger Stuhl (Vatikanstaat) countryVA
Honduras LandHN
Hongkong countryHK
Ungarn LandHU
Island LandIS
Indien countryIN
Indonesien countryID
Iran Land IR
Irak Land-IQ
Irland countryIE
Israel countryIL
Italien Land IT
Jamaika LandJM
Japan LandJP
Jordanien CountryJO
Kasachstan Land/KZ
Kenia CountryKE
Kiribati countryKI
Korea, Demokratische Volksrepublik Land/KP
Korea, Republik CountryKR
Kuwait CountryKW
Kirgisistan CountryKG
Laos Land LA
Lettland CountryLV
Libanon countryLB
Lesotho countryLS
Liberia LandLR
Libyen ländlich
Liechtenstein Land/Region
Litauen countryLT
Luxemburg LandLU
Macau countryMO
Nordmazedonien LandMK
Madagaskar LandesMG
Malawi CountryMW
Malaysia LandMY
Malediven LandMV
Mali Land ML
Malta countryMT
Marshallinseln LandMH
Martinique countryMQ
Mauretanien LandMR
Mauritius countryMU
Mayotte LandYT
Mexiko Land MX
Mikronesien, Föderierte Staaten von countryFM
Moldau, Republik CountryMD
Monaco LandMC
Mongolei LandMN
Montserrat countryMS
Marokko LandMA
Mosambik Land MZ
Myanmar Land MM
Namibia LandNA
Nauru countryNR
Nepal Land NP
Niederlande LandNL
Niederländische Antillen CountryAN
Neukaledonien countryNC
Neuseeland countryNZ
Nicaragua countryNI
Niger countryNE
Nigeria countryNG
Niue LandNU
Norfolkinsel LandNF
Nördliche Marianen Land MP
Norwegen LandNO
Oman CountryOM
Pakistan countryPK (LandPK)
Palau LandPW
Palästinensische Autonomiegebiete Land PS
Panama countryPA
Papua-Neuguinea Land PG
Paraguay LandPY
Peru LandPE
Philippinen LandPH
Pitcairn Länder-PN
Polen LandPL
Portugal PT (Land)
Puerto Rico Länder-PR
Katar QA für Land
Réunion LandRE
Rumänien countryRO
Russische Föderation countryRU
Ruanda countryRW
St. Helena countrySH
St. Kitts und Nevis countryKN
St. Lucia Länderspezifische Mindestanforderungen
St. Pierre und Miquelon countryPM
St. Vincent und die Grenadinen VC (Land)
Samoa countryWS
San Marino LandSM
São Tomé und Príncipe LandST
Saudi-Arabien countrySA
Senegal countrySN (LandSN)
Serbien und Montenegro CountryCS
Seychellen countrySC
Sierra Leone LandSL
Singapur LänderSG
Slowakei countrySK
Slowenien countrySI
Salomonen LandSB
Somalia LandSO
Südafrika LandZA
Südgeorgien und Südliche Sandwichinseln Land GS
Spanien Länder
Sri Lanka LandLK
Sudan Länder-SD
Suriname CountrySR
Svalbard und Jan Mayen countrySJ
Swasiland countrySZ (Land SZ)
Schweden countrySE
Schweiz countryCH
Syrien LandSY
Taiwan, Provinz von China LandTW
Tadschikistan LandTJ
Tansania LandTZ
Thailand LandTH
Togo LandTG
Tokelau LandTK
Tonga Land TO
Trinidad und Tobago countryTT
Tunesien LandTN
Türkei Land TR
Turkmenistan LandTM
Turks- und Caicosinseln LandTC
Tuvalu countrytv
Uganda Land UG
Ukraine LandUA
Vereinigte Arabische Emirate countryAE
Vereinigtes Königreich countryUK
USA Land USA
Kleinere Amerikanische Überseeinseln Land UM
Uruguay Land UY
Usbekistan LandUZ
Vanuatu Land
Venezuela countryVE
Vietnam Land VN
Britische Jungferninseln countryVG
Jungferninseln, Amerikanische LandVI
Wallis und Futuna Land WF
Westsahara Land EH
Jemen LandYE
Jugoslawien LandYU
Sambia Land ZM
Simbabwe LandZW

Ländercodes

In der folgenden Tabelle sind die aus zwei Buchstaben bestehenden Ländercodes aufgeführt, die als Werte des Parameters gl verwendet werden können:

Land Ländercode
Afghanistan af
Albanien al
Algerien dz
Amerikanisch-Samoa wie
Andorra Anzeige
Angola ao
Anguilla ai
Antarktis Aqua
Antigua und Barbuda AG
Argentinien ar
Armenien am
Aruba aw
Australien au
Österreich at
Aserbaidschan az
Bahamas bs
Bahrain bh
Bangladesch bd
Barbados bb
Belarus by
Belgien be
Belize BZ
Benin Bj
Bermuda bm
Bhutan BTS
Bolivien bo
Bosnien und Herzegowina ba
Botsuana SW
Bouvetinsel BV
Brasilien br
Britisches Territorium im Indischen Ozean io
Brunei Darussalam bn
Bulgarien bg
Burkina Faso Bf
Burundi bi
Kambodscha kh
Kamerun cm
Kanada ca
Cabo Verde cv
Kaimaninseln ky
Zentralafrikanische Republik konf.
Tschad td
Chile cl
China cn
Weihnachtsinsel cx
Kokosinseln (Keelinginseln) Cc
Kolumbien co
Komoren km
Kongo CG
Kongo, Demokratische Republik cd
Cookinseln ck
Costa Rica cr
Côte d'Ivoire CI
Kroatien Std.
Kuba CU
Zypern cy
Tschechien cz
Dänemark dk
Dschibuti DJ
Dominica dm
Dominikanische Republik do
Ecuador ec
Ägypten eg
El Salvador sv
Äquatorialguinea gq
Eritrea er
Estland ee
Äthiopien et
Falklandinseln KF
Färöer fo
Fidschi fj
Finnland fi
Frankreich fr
Französisch-Guayana GF
Französisch-Polynesien pf
Französische Südgebiete tf
Gabun ga
Gambia GM
Georgia ge
Deutschland de
Ghana gh
Gibraltar Gi
Griechenland gr
Grönland gl
Grenada gd
Guadeloupe GPS
Guam gu
Guatemala gt
Guinea gn
Guinea-Bissau gw
Guyana Gy
Haiti ht
Heard und die McDonaldinseln hm
Heiliger Stuhl (Vatikanstaat) va
Honduras hn
Hongkong hk
Ungarn hu
Island ist
Indien in
Indonesien id
Iran ir
Irak iQ
Irland ie
Israel il
Italien it
Jamaika jm
Japan jp
Jordanien jo
Kasachstan kz
Kenia ke
Kiribati ki
Korea, Demokratische Volksrepublik kp
Korea, Republik kr
Kuwait kw
Kirgisistan kg
Laos la
Lettland lv
Libanon lb
Lesotho ls
Liberia LR
Libyen ly
Liechtenstein li
Litauen lt
Luxemburg lu
Macau Monat
Nordmazedonien mk
Madagaskar mg
Malawi MW
Malaysia my
Malediven mv
Mali ml
Malta mt
Marshallinseln mh
Martinique mq
Mauretanien mr
Mauritius mu
Mayotte YouTube
Mexiko mx
Mikronesien, Föderierte Staaten von Frontline
Moldau, Republik MD
Monaco Mc
Mongolei mn
Montserrat ms
Marokko ma
Mosambik MZ
Myanmar mm
Namibia
Nauru NR
Nepal np
Niederlande nl
Niederländische Antillen eine
Neukaledonien C
Neuseeland nz
Nicaragua Ni
Niger ne
Nigeria ng
Niue Nu
Norfolkinsel NF
Nördliche Marianen MP
Norwegen Nein
Oman om
Pakistan pk
Palau Pw
Palästinensische Gebiete ps
Panama pa
Papua-Neuguinea S.
Paraguay py
Peru pe
Philippinen ph
Pitcairn PN
Polen pl
Portugal pt
Puerto Rico pr
Katar qa
Réunion Re
Rumänien ro
Russische Föderation ru
Ruanda rw
St. Helena sh
St. Kitts und Nevis kn
St. Lucia lc
St. Pierre und Miquelon p.m.
St. Vincent und die Grenadinen vc
Samoa ws
San Marino sm
São Tomé und Príncipe st
Saudi-Arabien sa
Senegal sn
Serbien und Montenegro cs
Seychellen S
Sierra Leone sl
Singapur sg
Slowakei sk
Slowenien si
Salomonen SB
Somalia so
Südafrika za
Südgeorgien und Südliche Sandwichinseln gs
Spanien es
Sri Lanka lk
Sudan sd
Suriname sr
Svalbard und Jan Mayen SJ
Swasiland S
Schweden se
Schweiz ch
Syrien Sy
Taiwan, Provinz von China tw
Tadschikistan TJ
Tansania tz
Thailand th
Timor-Leste tl
Togo tg
Tokelau tk
Tonga to
Trinidad und Tobago tt
Tunesien tn
Türkei tr
Turkmenistan tm
Turks- und Caicosinseln TC
Tuvalu tv
Uganda Ug
Ukraine ua
Vereinigte Arabische Emirate ae
Vereinigtes Königreich uk
USA us
Kleinere Amerikanische Überseeinseln ähm
Uruguay uy
Usbekistan uz
Vanuatu Vu
Venezuela ve
Vietnam vn
Britische Jungferninseln vg
Jungferninseln, Amerikanische vi
Wallis und Futuna WF
Westsahara Eh
Jemen ja
Sambia ZM
Simbabwe ZW