Załączniki do dokumentacji interfejsu API XML

Operatory logiczne

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

Definicje operatorów logicznych

Uwaga: nie można używać spacji w wartościach parametrów.

Wartość logiczna ORAZ [.]
Opis

Operator AND (.) zwraca wyniki, które znajdują się w miejscu przecięcia zbiorów z operatorem „.”.
Przykłady

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

Wartość logiczna NOT [-]
Opis

Operator NOT (.) usuwa wszystkie wyniki, które znajdują się w zbiorze tuż po operatorze 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: w drugim przykładzie w przykładzie powyżej użyto operatora logicznego AND, który wskazuje, że wyniki nie powinny być napisane w języku francuskim ani włoskim. W zależności od rozmieszczenia nawiasów w zapytaniu do wyrażenia tego zapytania możesz użyć operatora logicznego AND lub operatora logicznego LUB. Dzieje się tak, ponieważ dokumenty napisane w języku francuskim nie są napisane w języku włoskim. Dlatego wyrażenie w polu wartości logicznej musi określać, że dokument nie jest napisany w języku francuskim a nie w języku włoskim.

Wartość logiczna LUB [|]
Opis

Operator OR (.) zwraca wyniki, które znajdują się w zbiorze po lewej stronie lub po prawej stronie operatora pionowej kreski („|”).
Przykłady

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

W tym przykładzie żądamy wszystkich wyników, które nie są napisane w języku francuskim ani włoskim. Zauważ, że nawiasy znajdują się w innej lokalizacji niż przykładowe zapytanie w przypadku operatora logicznego AND:
lr=-(lang_fr|lang_it)


Nawiasy logiczne [()]
Opis

Ten operator daje pewność, że sprawdzane są wszystkie hasła w najbardziej wewnętrznym zestawie nawiasów przed uwzględnieniem haseł spoza nawiasów. Możesz użyć nawiasów, by określić kolejność pomijania haseł.
Przykłady

Przykład operatora NOT [-] pokazuje następujący obiekt dla wyników żądań, które nie są napisane w języku francuskim ani włoskim:
lr=(-lang_fr).(-lang_it)

Przykład operatora OR (|) pokazuje też żądanie wyników napisanych w języku francuskim lub włoskim. W tym drugim przykładzie używany jest operator OR, a nie operator AND, więc trzeba też zmienić lokalizację nawiasów:
lr=-(lang_fr|lang_it)

Zmiana znaczenia adresu URL

Jeśli chcesz utworzyć żądanie wyszukiwania HTTP, przestrzegaj określonych konwencji. Dzięki temu Google będzie w stanie poprawnie przetłumaczyć żądanie HTTP i wygenerować odpowiednią odpowiedź.

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 znaków zarezerwowanych do dekodowania adresów URL i określonych znaków specjalnych w żądaniach związanych z funkcjami wyszukiwania. Dlatego musisz zmienić znaczenie wszystkich znaków niealfanumerycznych w adresach URL, które występują w wartościach parametrów wyszukiwania.

Aby zmienić znaczenie ciągu znaków w adresie URL, przekonwertuj każdą sekwencję znaków odstępu na pojedynczy znak „+” (znak plusa), a wszystkie pozostałe znaki niealfanumeryczne zastąp kodowaniem szesnastkowym, które reprezentuje wartość danego znaku. Kodowanie szesnastkowe znaków specjalnych i zarezerwowanych wymienionych powyżej znajdziesz w tabeli poniżej. Każdy z tych znaków powinien zawierać kody zmiany znaczenia adresu URL w wartościach parametrów żądania.

Znak Kodowanie
szesnastkowe
$ 24
- %2 d
_ %5F
. %2E
+ %2 mld
! 21
* %2A
” 22
' 27
( 28 %
) 29
; %3 mld
/ %2F
? %3F
: %3A
@ 40%
= %3D
i 26
| %7C

Przykłady

Oryginalny ciąg znaków Ciąg znaków ze zmianą znaczenia adresu URL
cios&judy cios%26judy
O'Reilly Reilly

Dodatkowe informacje o zmianie znaczenia adresów URL znajdziesz na stronach W3C oraz IETF.

Kompresowanie wyników

Google może kompresować wyniki wyszukiwania za pomocą kompresji HTTP gzip. Jeśli możesz dekompresować treść skompresowaną za pomocą algorytmu gzip, możesz uzyskać od 50 do 70% oszczędności 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:

Accept-Encoding: gzip

Jeżeli Google zwróci wyniki wyszukiwania przy użyciu kompresji gzip, w zwróconych nagłówkach HTTP uwzględniamy następujący wiersz:

Kodowanie treści: gzip

Uwaga: jeśli w odpowiedzi, jak pokazano powyżej, nie ma nagłówka HTTP Content-Encoding, oznacza to, że nie skompresowaliśmy wyników.

To zachowanie jest opisane w standardzie HTTP. Dodatkowe informacje na temat korzystania 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. Możesz przypisać wartości parametrów ie i oe w każdej z 2 pierwszych kolumn tej tabeli. Wartości w pierwszej kolumnie to pseudonimy dla schematów kodowania, a wartości w drugiej kolumnie to standardowe nazwy schematów kodowania. W wynikach wyszukiwania Google Google zwraca nazwy standardowe, a nazwy standardowe są odpowiednie do użycia w nagłówkach HTTP Content-type.

Nazwa Google Kodowanie Powiązane obsługiwane języki
latin1 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łtycki (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;
latin5 ISO-8859-9  
latin6 ISO-8859-10 islandzki
euc-jp EUC-JP japoński
Euc-kr EUC-KR koreański
Sisis Shift_JIS japoński
big5 Big5 chiński tradycyjny
gb GB2312 chiński uproszczony
utf8 UTF-8 Wszystko

Obsługiwane języki interfejsu

Google obsługuje 74 języki. Domyślnym językiem interfejsu jest angielski. Na liście poniżej znajdziesz listę wszystkich języków interfejsu obsługiwanych przez Google.

Język wyświetlania Wartość parametru hl
afrikaans af
albański sq
amharski AM
arabski ar
ormiański hy
azerski az
bengalski bn
bułgarski; bg
birmański my
kataloński ca
chiński (uproszczony) zh-CN
chiński (tradycyjny) zh-TW
chorwacki h
czeski cs
duński da
niderlandzki nl
angielski (Wlk. Brytania) en-GB
angielski en
estoński et
filipiński fil
fiński fi
francuski (Kanada) fr-CA
Francuski fr
gruziński ka
niemiecki de
grecki el
gudżarati gu
hebrajski; iw
hindi hi
węgierski hu
islandzki jest
indonezyjski id
włoski it
japoński ja
kannada kn
kazachski kk
khmerski km
koreański ko
kirgiski ky
laotański lo
łotewski lv
litewski lt
macedoński mk
malajski ms
Malajam ml
marathi mr
mongolski mn
nepalski ne
norweski (bokmål) nie
perski fa
Polski pl
portugalski (Brazylia) pt-BR
portugalski (Portugalia) pt-PT
pendżabski pa
rumuński ro
rosyjski ru
serbski (alfabet łaciński) sr-Latn
serbski sr
syngaleski si
słowacki sk
słoweński sl
hiszpański (Ameryka Łacińska) es-419
Hiszpański es
suahili sw
szwedzki sv
tamilski ta
telugu te
tajski th
turecki tr
ukraiński uk
urdu ur
uzbecki uz
wietnamski vi
walijski cy

Wartości zbioru językowego

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_en
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 zbierania danych wg kraju

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

Kraj Nazwa kolekcji dotyczącej kraju
Afganistan countryAF
Albania countryAL
Algieria countryDZ
Samoa Amerykańskie countryAS
Andora countryAD
Angola countryAO
Anguilla countryAI
Antarktyka countryAQ
Antigua i Barbuda countryAG
Argentyna countryAR
Armenia countryAM
Aruba countryAW
Australia countryAU
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 countryBR
Brytyjskie Terytorium Oceanu Indyjskiego countryIO
Brunei countryBN
Bułgaria countryBG
Burkina Faso countryBF
Burundi countryBI
Kambodża countryKH
Kamerun countryCM
Kanada countryCA
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 countryCD
Wyspy Cooka countryCK
Kostaryka countryCR
Wybrzeże Kości Słoniowej countryCI
Chorwacja countryHR
Kuba countryCU
Cypr countryCY
Czechy countryCZ
Dania countryDK
Dżibuti countryDJ
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) countryFK
Wyspy Owcze countryFO
Fidżi countryFJ
Finlandia countryFI
Francja countryFR
Francja, bez kolonii countryFX
Gujana Francuska countryGF
Polinezja Francuska countryPF
Francuskie Terytoria Południowe i Antarktyczne countryTF
Gabon countryGA
Gambia countryGM
Gruzja countryGE
Niemcy countryDE
Ghana countryGH
Gibraltar countryGI
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) countryVA
Honduras countryHN
Hongkong countryHK
Węgry countryHU
Islandia countryIS
Indie countryIN
Indonezja countryID
Iran countryIR
Irak countryIQ
Irlandia countryIE
Izrael countryIL
Włochy countryIT
Jamajka countryJM
Japonia countryJP
Jordania countryJO
Kazachstan countryKZ
Kenia countryKE
Kiribati countryKI
Korea Północna countryKP
Korea Południowa countryKR
Kuwejt countryKW
Kirgistan countryKG
Laos countryLA
Łotwa countryLV
Liban countryLB
Lesotho countryLS
Liberia countryLR
Libia countryLY
Liechtenstein countryLI
Litwa countryLT
Luksemburg countryLU
Makau countryMO
Macedonia Północna countryMK
Madagaskar countryMG
Malawi countryMW
Malezja countryMY
Malediwy countryMV
Mali countryML
Malta countryMT
Wyspy Marshalla countryMH
Martynika countryMQ
Mauretania countryMR
Mauritius countryMU
Majotta countryYT
Meksyk countryMX
Mikronezja countryFM
Mołdawia countryMD
Monako countryMC
Mongolia countryMN
Montserrat countryMS
Maroko countryMA
Mozambik countryMZ
Mjanma (Birma) countryMM
Namibia countryNA
Nauru countryNR
Nepal countryNP
Holandia countryNL
Antyle Holenderskie countryAN
Nowa Kaledonia countryNC
Nowa Zelandia countryNZ
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 countryPH
Pitcairn countryPN
Polska countryPL
Portugalia countryPT
Portoryko countryPR
Katar countryQA
Reunion countryRE
Rumunia countryRO
Rosja countryRU
Rwanda countryRW
Wyspa Świętej Heleny countrySH
Saint Kitts i Nevis countryKN
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 countrySN
Serbia i Montenegro countryCS
Seszele countrySC
Sierra Leone countrySL
Singapur countrySG
Słowacja countrySK
Słowenia countrySI
Wyspy Salomona countrySB
Somalia countrySO
Republika Południowej Afryki countryZA
Georgia Południowa i Sandwich Południowy countryGS
Hiszpania countryES
Sri Lanka countryLK
Sudan countrySD
Surinam countrySR
Svalbard i Jan Mayen countrySJ
Suazi countrySZ
Szwecja countrySE
Szwajcaria countryCH
Syria countrySY
Tajwan (prowincja Chin) countryTW
Tadżykistan countryTJ
Tanzania countryTZ
Tajlandia countryTH
Togo countryTG
Tokelau countryTK
Wyspy 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

W tabeli poniżej znajdziesz 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
Antarktyka aq
Antigua i Barbuda ag
Argentyna ar
Armenia AM
Aruba aw
Australia au
Austria w
Azerbejdżan az
Bahamy bs
Bahrajn bh
Bangladesz bd
Barbados bb
Białoruś do
Belgia be
Belize BZ
Benin BJ
Bermudy BM
Bhutan bt
Boliwia bo
Bośnia i Hercegowina ba
Botswana bw
Wyspa Bouveta BV
Brazylia br
Brytyjskie Terytorium Oceanu Indyjskiego io
Brunei bn
Bułgaria bg
Burkina Faso bf
Burundi Bi
Kambodża kh
Kamerun cm
Kanada ca
Republika Zielonego Przylądka cv
Kajmany ky
Republika Środkowoafrykańska cf
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 ck
Kostaryka cr
Wybrzeże Kości Słoniowej ci
Chorwacja h
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 Fidżi
Finlandia fi
Francja fr
Gujana Francuska GF
Polinezja Francuska pf
Francuskie Terytoria Południowe i Antarktyczne tf
Gabon ga
Gambia gm
Gruzja ge
Niemcy de
Ghana gh
Gibraltar Gi
Grecja gr
Grenlandia gl
Grenada gd
Gwadelupa gp
Guam gu
Gwatemala gt
Gwinea G
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 w
Indonezja id
Iran ir
Irak IQ
Irlandia ie
Izrael il
Włochy włoski
Jamajka JZM
Japonia jp
Jordania jo
Kazachstan kz
Kenia ke
Kiribati ki
Korea Północna kp
Korea Południowa kr
Kuwejt kw
Kirgistan kg
Laos la
Łotwa lv
Liban lb
Lesotho ls
Liberia lr
Libia ly
Liechtenstein li
Litwa lt
Luksemburg lu
Makau miesięcznie
Macedonia Północna mk
Madagaskar mg
Malawi mw
Malezja my
Malediwy mv
Mali ml
Malta mt
Wyspy Marshalla mh
Martynika mq
Mauretania mr
Mauritius mu
Majotta yt
Meksyk mx
Mikronezja fm
Mołdawia md
Monako Mc
Mongolia mn
Montserrat ms
Maroko ma
Mozambik mz
Mjanma (Birma) mm
Namibia no nie
Nauru nr
Nepal np
Holandia nl
Antyle Holenderskie Jakiś
Nowa Kaledonia nc
Nowa Zelandia nz
Nikaragua ni
Niger ne
Nigeria ng
Niue nu
Wyspa Norfolk NUK
Mariany Północne mp
Norwegia nie
Oman om
Pakistan pk
Palau pw
Palestyna ps
Panama pa
Papua-Nowa Gwinea str.
Paragwaj py
Peru pe
Filipiny ph
Pitcairn PN
Polska pl
Portugalia pt
Portoryko pr
Katar qa
Reunion odpowiedź
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 kam.
Arabia Saudyjska sa
Senegal sn
Serbia i Montenegro 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 gs
Hiszpania es
Sri Lanka lk
Sudan sd
Surinam sr
Svalbard i Jan Mayen SJ
Suazi sz
Szwecja se
Szwajcaria ch
Syria Sy
Tajwan (prowincja Chin) tw
Tadżykistan tj
Tanzania tz
Tajlandia th
Timor Wschodni tl
Togo tg
Tokelau tk
Wyspy 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 eh
Jemen taa
Zambia zm
Zimbabwe zw