Materiały referencyjne interfejsu XML API

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Operatory logiczne

Operatorów logicznych możesz używać w wartościach tych parametrów:

Definicje operatorów logicznych

Uwaga: wartości parametrów nie mogą zawierać spacji.

Wartość logiczna [.]
Description

Operator AND (.) zwraca wyniki, które znajdują się w przedziale zbiorów i znajdują się po obu stronach operatora „.”.

Przykłady

Ten przykład usuwa wszystkie wyniki w języku francuskim lub włoskim:
lr=(-lang_fr).(-lang_it)


Wartość logiczna NIE [-]
Description

Operator NOT (.) usuwa wszystkie wyniki znajdujące się w kolekcji bezpośrednio po znaku minusa („-”).

Przykłady

Ten przykład usuwa wszystkie wyniki w języku francuskim:
lr=-lang_fr

Ten przykład usuwa wszystkie wyniki w języku francuskim lub włoskim:
lr=(-lang_fr).(-lang_it)

Uwaga: być może zauważysz, że w drugim przykładzie użyto operatora Boolean AND AND, aby określić, że wyniki nie powinny być zapisywane w języku francuskim ani włoskim. W zależności od tego, gdzie w zapytaniu znajduje się nawias, możesz użyć w tym przypadku operatora Boolean AND lub Boolean OR OR. Wynika to z faktu, że dokument jest w języku francuskim, a nie w języku włoskim. W związku z tym dokument z wartością logiczną musi wskazywać, że dokument nie jest napisany w języku francuskim i nie jest napisany w języku włoskim.


Wartość logiczna [|]
Description

Operator OR (.) zwraca wyniki, które są w kolekcji po lewej stronie lub po prawej stronie operatora („|”).

Przykłady

Ten przykład zwraca wszystkie wyniki napisane w języku chińskim uproszczonym lub tradycyjnym:
lr=lang_zh-TW|lang_zh-CN

W tym przykładzie zażądano wszystkich wyników, które nie są w języku francuskim ani włoskim. Zwróć uwagę, że umieszczasz nawiasy w innej lokalizacji niż przykładowe zapytanie operatora logicznego AND:
lr=-(lang_fr|lang_it)


Nawiasy logiczne [()]
Description

Ten operator pozwala sprawdzić, czy wszystkie terminy znajdujące się w najbardziej wewnętrznym zestawie nawiasów są oceniane przed oceną warunków poza nawiasami. Możesz używać nawiasów, aby określać kolejność ewakuacji wyszukiwanych haseł.

Przykłady

Przykład operatora NOT [-] pokazuje w wyniku żądania taki wynik, który nie jest napisany w języku francuskim ani włoskim:
lr=(-lang_fr).(-lang_it)

W przypadku operatora OR (|) wyświetlane jest też żądanie dotyczące wyników w językach innych niż francuski. W tym drugim przykładzie użyto operatora OR zamiast operatora AND, dlatego musisz też zmienić lokalizację nawiasów:
lr=-(lang_fr|lang_it)


Zmiana znaczenia adresu URL

Aby utworzyć żądanie wyszukiwania HTTP, musisz przestrzegać pewnych konwencji, aby umożliwić Google prawidłowe tłumaczenie żądania HTTP i generowanie odpowiedniej odpowiedzi.

Schemat adresu URL HTTP określa, że żądanie adresu URL HTTP może zawierać tylko określone znaki:

  • Znaki alfanumeryczne: (a–z, A–Z, 0–9)
  • Znaki specjalne: $ - _ . | + !* ' ( )
  • Zarezerwowane znaki: ; / ? : @ = &

Google używa zastrzeżonych znaków do dekodowania adresów URL i używa określonych znaków specjalnych do pobierania funkcji wyszukiwania. W związku z tym adresy URL powinny zawierać znaki zmiany znaczenia, które występują w wartościach parametrów wyszukiwania.

Aby zmienić adres URL w postaci zmiany znaczenia ciągu, zastąp każdą sekwencję znaków odstępu znakiem plusa (+) i zastąp pozostałe znaki niealfanumeryczne kodowaniem szesnastkowym, które reprezentuje wartość tego znaku. W tej tabeli podano szesnastkowe kodowanie znaków specjalnych i zarezerwowanych. W wartościach parametrów każdego z tych znaków należy zmieniać znaczenie adresu URL.

Postać Kodowanie szesnastkowe
$ %24
%2D
_ %5F
. %2E
PONAD %2 mld
! %21
* %2A
" %22
' %27
( %28
) %29
; %3 mld
/ %2F
? %3F
: %3A
@ %40
= %3D
& %26
| %7C

Przykłady

Oryginalny ciąg znaków Ciąg znaków zmiany znaczenia adresu URL
poncz&judy ponton%26judy
O'Reilly O%27Reilly

Dodatkowe informacje o zmianie znaczenia adresu URL znajdziesz w witrynach W3C i IETF.

Kompresowanie wyników

Google może kompresować wyniki wyszukiwania za pomocą kompresji HTTP gzip. Jeśli możesz zdekompresować treści, które są skompresowane za pomocą algorytmu gzip, możesz zaoszczędzić od 50 do 70% przepustowości, co może skrócić czas odpowiedzi.

Aby umożliwić Google zwracanie wyników w formacie skompresowanym, dodaj do żądania wyszukiwania HTTP nagłówek Accept-Encoding w ten sposób:

Accept-Encoding: gzip

Jeśli Google zwraca wyniki wyszukiwania za pomocą kompresji gzip, w nagłówkach HTTP tego wiersza umieszczamy ten wiersz:

Kodowanie treści: gzip

Uwaga: jeśli w odpowiedzi nie ma nagłówka HTTP Content-Encoding, Google nie skompresował(a) wyników.

Ten sposób działania jest określony w standardzie HTTP. Więcej informacji o korzystaniu z kompresji HTTP gzip znajdziesz w tym dokumencie.

Wartości międzynarodowe

Schematy kodowania znaków

W tabeli poniżej znajdziesz schematy kodowania znaków obsługiwane przez Google. Parametrom ie i oe możesz przypisać wartości w jednej z 2 pierwszych kolumn tej tabeli. Wartości w pierwszej kolumnie są pseudonimami schematów kodowania, a wartości w drugiej są standardowymi nazwami schematów kodowania. Google zwraca nazwy standardowe w wynikach XML. Nazwy te są odpowiednie do użycia w nagłówkach HTTP Content-type dokumentu.

Nazwa Google Kodowanie Powiązane obsługiwane języki
latin2 ISO 8859-1 zachodnioeuropejskie (angielski, duński, fiński, francuski, hiszpański, indonezyjski, kataloński, niderlandzki, niemiecki, norweski, portugalski, szwedzki, włoski)
latin2 ISO 8859-2 wschodnioeuropejskie (chorwacki, czeski, polski, rumuński, serbski, słowacki, słoweński, węgierski)
latin3 ISO 8859-3  
latin4 ISO 8859-4 bałtyckie (estoński, litewski, łotewski)
cyrylica ISO 8859-5 bułgarski, rosyjski
arabski ISO 8859-6  
grecki ISO 8859-7 grecki
hebrajski ISO 8859-8 hebrajski
latynoska ISO 8859-9  
latin6 ISO 8859-10 islandzki
euc-jp EUC-JP japoński
euk-kr- EUC-KR koreański
Sjis Shift_JIS japoński
wielkie 5 Duży 5 chiński tradycyjny
gb GB2312 Chiński uproszczony
TWF8 UTF-8; Wszystko

Obsługiwane języki interfejsu

Google obsługuje ponad 80 języków. Domyślny język interfejsu to angielski. Na liście poniżej znajdziesz wszystkie języki interfejsu obsługiwane przez Google.

Język wyświetlania Wartość parametru hl
afrikaans af
albański sq
amharski sm
arabski ar
Azerski az
baskijski eu
Białoruski be
bengalski bn
Bihari bh
bośniacki bs
bułgarski bg
kataloński ca
chiński (uproszczony) zh-CN
chiński (tradycyjny) zh-TW
chorwacki godz.
czeski cs
duński da
niderlandzki nl
angielski ang.
esperanto Eo
estoński et
farerski fo
fiński fi
francuski fr
fryzyjski Fy
galicyjski gl
gruziński ka
niemiecki de
grecki el
gudżarati gu
hebrajski iw
hindi hi
węgierski hu
islandzki jest
indonezyjski id
interlingua ja
irlandzki ga
włoski it
japoński ja
jawajski JW
kannada kn
koreański ko
łaciński la
łotewski lv
litewski lt
macedoński mk
malajski ms
malajski ml
maltański mt
marathi mr
nepalski ne
norweski, nie
norweski (nynorsk) Nr
oksytański ok
perski fa
polski pl
portugalski (Brazylia) pt-BR
portugalski (Portugalia) pt-PT
pendżabski pa
rumuński ro
rosyjski ru
szkocki gaelicki gd
serbski sr
syngaleski si
słowacki sk
słoweński sl
hiszpański es
sudański su
suahili sw
szwedzki. sv
tagalog TL
tamilski ta
telugu te
tajski th
tigrinya ti
turecki tr
ukraiński uk
urdu ur
uzbecki uz
wietnamski vi
walijski cy
Xhosa xh
zulu zu

Wartości zbioru języków

Aby określić filtr języka za pomocą parametru zapytania lr, możesz użyć tych wartości:

Język Wartość parametru lr
arabski lang_ar,
bułgarski lang_bg
kataloński lang_ca,
chiński (uproszczony) lang_zh-CN
chiński (tradycyjny) lang_zh-TW
chorwacki lang_hr
czeski lang_cs
duński lang_da
niderlandzki lang_nl
angielski lang_pl
estoński lang_et
fiński lang_fi
francuski lang_fr
niemiecki lang_de
grecki lang_el
hebrajski lang_iw
węgierski lang_hu
islandzki lang_is
indonezyjski lang_id,
włoski lang_it
japoński lang_ja
koreański lang_ko
łotewski lang_lv,
litewski lang_lt,
norweski, lang_no
polski lang_pl
portugalski lang_pt
rumuński lang_ro
rosyjski lang_ru
serbski lang_sr,
słowacki lang_sk
słoweński lang_sl
hiszpański lang_es
szwedzki. lang_sv,
turecki lang_tr

Wartości zbioru krajów

Aby określić filtr kraju za pomocą parametru zapytania cr, możesz użyć tych wartości:

Kraj Nazwa kraju
Afganistan countryAF
Albania countryAL
Algieria countryDZ
Samoa Amerykańskie countryAS
Andora countryAD
Angola countryAO
Anguilla countryAI
Antarktyda countryAQ
Antigua i Barbuda countryAG
Argentyna countryAR
Armenia countryAM
Aruba countryAW
Australia AUAU
Austria countryAT
Azerbejdżan countryAZ
Bahamy countryBS
Bahrajn countryBH
Bangladesz countryBD
Barbados countryBB
Białoruś countryBY
Belgia countryBE
Belize countryBZ
Benin countryBJ
Bermudy countryBM
Bhutan countryBT
Boliwia countryBO
Bośnia i Hercegowina countryBA
Botswana countryBW
Wyspa Bouveta countryBV
Brazylia krajBR
Brytyjskie Terytorium Oceanu Indyjskiego countryIO
Brunei countryBN
Bułgaria countryBG
Burkina Faso countryBF
Burundi countryBI
Kambodża countryKH
Kamerun CMCM
Kanada country-CA
Republika Zielonego Przylądka countryCV
Kajmany countryKY
Republika Środkowoafrykańska countryCF
Czad countryTD
Chile countryCL
Chiny countryCN
Wyspa Bożego Narodzenia countryCX
Wyspy Kokosowe (Keelinga) countryCC
Kolumbia countryCO
Komory countryKM
Kongo countryCG
Demokratyczna Republika Konga CDC country
Wyspy Cooka countryCK
Kostaryka countryCR
Wybrzeże Kości Słoniowej countryCIC
Chorwacja countryHR
Kuba countryCUC
Cypr countryCYKL
Czechy country cze
Dania countryDK
Dżibuti countryJJ
Dominika countryDM
Dominikana countryDO
Timor Wschodni countryTP
Ekwador countryEC
Egipt countryEG
Salwador countrySV
Gwinea Równikowa countryGQ
Erytrea countryER
Estonia countryEE
Etiopia countryET
Unia Europejska countryEU
Falklandy (Malwiny) countryK
Wyspy Owcze countryFOFO
Fidżi countryFJ
Finlandia countryFI
Francja krajFR
Francja, bez kolonii countryFX,
Gujana Francuska countryGF
Polinezja Francuska countryPF
Francuskie Terytoria Południowe i Antarktyczne countryTF
Gabon country-GA
Gambia countryGM
Georgia countryGE
Niemcy countryDE
Ghana countryGH
Gibraltar countryGIG
Grecja countryGR
Grenlandia countryGL
Grenada countryGD
Gwadelupa countryGP,
Guam countryGU
Gwatemala countryGT
Gwinea countryGN
Gwinea Bissau countryGW
Gujana countryGY
Haiti countryHT,
Wyspy Heard i McDonalda countryHM
Stolica Apostolska (Watykan) country-VA
Honduras countryHN,
Hongkong countryHK
Węgry countryHU
Islandia countryIS
Indie countryIN
Indonezja countryID
Iran IR country
Irak countryIQ
Irlandia countryIE.
Izrael countryIL,
Włochy countryIT
Jamajka countryJM
Japonia countryJP
Jordania countryJO
Kazachstan countryKZ
Kenia countryKE
Kiribati country-ki
Korea Północna countryKP
Korea Południowa krajKR
Kuwejt countryKW
Kirgistan countryKG
Laos countryLA
Łotwa krajowa-wyborcza
Liban system równoważenia obciążenia country
Lesoto countryLS
Liberia countryLR
Libia krajowy
Liechtenstein countryLI
Litwa countryLT
Luksemburg countryLU
Makau countryMO
Macedonia countryMK
Madagaskar countryMG
Malawi countryMW
Malezja countryMY
Malediwy countryMV
Mali countryML
Malta countryMT,
Wyspy Marshalla countryMHH
Martynika countryMQ
Mauretania countryMR
Mauritius countryMU
Majotta country-YT
Meksyk countryMX
Mikronezja countryFM
Mołdawia countryMD
Monako countryMC
Mongolia countryMN
Montserrat countryMS
Maroko countryMAMA
Mozambik countryMZ
Birma countryMM
Namibia countryNA
Nauru countryNR
Nepal countryNPN
Holandia countryNL
Antyle Holenderskie countryAN
Nowa Kaledonia countryNC
Nowa Zelandia country-NZ
Nikaragua countryNI
Niger countryNE
Nigeria countryNG
Niue countryNU
Wyspa Norfolk countryNF
Mariany Północne countryMP
Norwegia countryNO
Oman countryOM
Pakistan countryPK
Palau countryPW
Terytorium Palestyńskie countryPS
Panama countryPA
Papua-Nowa Gwinea countryPG
Paragwaj countryPY
Peru countryPE
Filipiny krajPH
Pitcairn countryPN,
Polska countryPL
Portugalia countryPT
Portoryko countryPR
Katar kontrola jakości kraju
Reunion countryRE
Rumunia countryRO
Rosja countryRU
Rwanda countryRW
Wyspa Świętej Heleny countrySH
Saint Kitts i Nevis krajKN
Saint Lucia countryLC
Saint-Pierre i Miquelon countryPM
Saint Vincent i Grenadyny countryVC
Samoa countryWS
San Marino countrySM
Wyspy Świętego Tomasza i Książęca countryST
Arabia Saudyjska countrySA
Senegal krajSN
Serbia i Czarnogóra countryCS
Seszele countrySC
Sierra Leone countrySL
Singapur countrySG
Słowacja countrySK
Słowenia countrySI
Wyspy Salomona countrySB
Somalia countrySO
Republika Południowej Afryki countryzaza
Georgia Południowa i Sandwich Południowy countryGS
Hiszpania countryES
Sri Lanka countryLK
Sudan countrySD
Surinam countrySR
Svalbard i Jan Mayen countrySJ
Eswatini countrySZ
Szwecja countrySE
Szwajcaria countryCH
Syria countrySY
Tajwan (prowincja Chin) countryTW
Tadżykistan countryTJ
Tanzania countryTZ
Tajlandia countryTH
Togo countryTG
Tokelau countryTK
Tonga countryTO
Trynidad i Tobago countryTT
Tunezja countryTN
Turcja countryTR
Turkmenistan countryTM
Turks i Caicos countryTC
Tuwalu countryTV
Uganda countryUG
Ukraina countryUA
Zjednoczone Emiraty Arabskie countryAE
Wielka Brytania countryUK
Stany Zjednoczone countryUS
Dalekie Wyspy Mniejsze Stanów Zjednoczonych countryUM
Urugwaj countryUY
Uzbekistan countryUZ
Vanuatu countryVU
Wenezuela countryVE
Wietnam countryVN
Brytyjskie Wyspy Dziewicze countryVG
Wyspy Dziewicze Stanów Zjednoczonych countryVI
Wallis i Futuna countryWF
Sahara Zachodnia countryEH
Jemen countryYE
Jugosławia countryYU
Zambia countryZM
Zimbabwe countryZW

Kody krajów

Poniższa tabela zawiera dwuliterowe kody krajów, których można używać jako wartości parametru gl:

Kraj Kod kraju
Afganistan af
Albania Al
Algieria dz
Samoa Amerykańskie Jako
Andora reklamie
Angola Ao
Anguilla ai
Antarktyda woda
Antigua i Barbuda śr.
Argentyna ar
Armenia AM
Aruba AW
Australia au
Austria at
Azerbejdżan az
Bahamy bs
Bahrajn bh
Bangladesz bd
Barbados bb
Białoruś Użytkownik
Belgia be
Belize BZ
Benin bj
Bermudy bm
Bhutan bt
Boliwia bo
Bośnia i Hercegowina Ba
Botswana cz-b
Wyspa Bouveta BV
Brazylia br
Brytyjskie Terytorium Oceanu Indyjskiego Io
Brunei bn
Bułgaria bg
Burkina Faso UDW
Burundi bi
Kambodża kh
Kamerun cm
Kanada ca
Republika Zielonego Przylądka CV
Kajmany ky
Republika Środkowoafrykańska gk
Czad td
Chile cl
Chiny cn
Wyspa Bożego Narodzenia CX
Wyspy Kokosowe (Keelinga) DW
Kolumbia co
Komory km
Kongo CG
Demokratyczna Republika Konga cd
Wyspy Cooka siatka
Kostaryka cr
Wybrzeże Kości Słoniowej ci
Chorwacja godz.
Kuba cu
Cypr cy
Czechy cz
Dania dk
Dżibuti DJ
Dominika DM
Dominikana do
Ekwador ec
Egipt eg
Salwador sv
Gwinea Równikowa GQ
Erytrea promienia Ziemi
Estonia ee
Etiopia et
Falklandy (Malwiny) fk
Wyspy Owcze fo
Fidżi FJ
Finlandia fi
Francja fr
Gujana Francuska Gf
Polinezja Francuska str.
Francuskie Terytoria Południowe i Antarktyczne tf,
Gabon ga
Gambia GM
Georgia ge
Niemcy de
Ghana gh
Gibraltar gi
Grecja gr
Grenlandia gl
Grenada gd
Gwadelupa GGP
Guam gu
Gwatemala gt
Gwinea Ggn
Gwinea Bissau gw
Gujana Gy
Haiti HT
Wyspy Heard i McDonalda hm
Stolica Apostolska (Watykan) va
Honduras hn
Hongkong hk
Węgry hu
Islandia jest
Indie in
Indonezja id
Iran ir
Irak IQ
Irlandia ie
Izrael il
Włochy it
Jamajka
Japonia jp
Jordania jo
Kazachstan kz
Kenia ke
Kiribati ki
Korea Północna kb/s
Korea Południowa kr
Kuwejt kw
Kirgistan kg
Laos la
Łotwa lv
Liban lb
Lesoto l
Liberia lr
Libia li
Liechtenstein li
Litwa lt
Luksemburg lu
Makau miesiąc
Macedonia mk
Madagaskar mg
Malawi MW
Malezja my
Malediwy mv
Mali ml
Malta mt
Wyspy Marshalla mh
Martynika mq
Mauretania mr
Mauritius M
Majotta yt
Meksyk mx
Mikronezja fm
Mołdawia md,
Monako Mc
Mongolia mn
Montserrat ms
Maroko ma
Mozambik MZ
Birma mm
Namibia no nie
Nauru nr
Nepal np
Holandia nl
Antyle Holenderskie instancję
Nowa Kaledonia N
Nowa Zelandia nz
Nikaragua Ni
Niger ne
Nigeria ng
Niue nu
Wyspa Norfolk NFS
Mariany Północne Mp
Norwegia nie
Oman om
Pakistan pk
Palau pw
Palestyna sek.
Panama pa
Papua-Nowa Gwinea str.
Paragwaj py
Peru pe
Filipiny ph
Pitcairn kp
Polska pl
Portugalia pt
Portoryko pr
Katar qa
Reunion Re
Rumunia ro
Rosja ru
Rwanda rw
Wyspa Świętej Heleny SH
Saint Kitts i Nevis kn
Saint Lucia lc
Saint-Pierre i Miquelon po południu
Saint Vincent i Grenadyny vc
Samoa ws
San Marino sm
Wyspy Świętego Tomasza i Książęca st
Arabia Saudyjska sa
Senegal sen
Serbia i Czarnogóra cs
Seszele Sc
Sierra Leone sl
Singapur sg
Słowacja sk
Słowenia si
Wyspy Salomona sb
Somalia dogr.
Republika Południowej Afryki za
Georgia Południowa i Sandwich Południowy G
Hiszpania es
Sri Lanka k
Sudan SD
Surinam sr
Svalbard i Jan Mayen SJ
Eswatini sz
Szwecja se
Szwajcaria ch
Syria Sy
Tajwan (prowincja Chin) tw
Tadżykistan tj.
Tanzania tz
Tajlandia th
Timor Wschodni TL
Togo tg
Tokelau bln
Tonga  
Trynidad i Tobago tt
Tunezja TN
Turcja tr
Turkmenistan tm,
Turks i Caicos tc
Tuwalu telewizor
Uganda ug
Ukraina ua
Zjednoczone Emiraty Arabskie ae
Wielka Brytania uk
Stany Zjednoczone us
Dalekie Wyspy Mniejsze Stanów Zjednoczonych yyy
Urugwaj uy
Uzbekistan uz
Vanuatu VU
Wenezuela ve
Wietnam vn
Brytyjskie Wyspy Dziewicze vg
Wyspy Dziewicze Stanów Zjednoczonych vi
Wallis i Futuna wf,
Sahara Zachodnia ej
Jemen taa
Zambia zm
Zimbabwe ZW