Załączniki do dokumentacji interfejsu API XML

Operatory logiczne

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

Definicje operatorów logicznych

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

Wartość logiczna ORAZ [.]
Opis

Operator AND (.) zwraca wyniki, które znajdują się w miejscach wspólnych zbiorów 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 [-]
Opis

Operator NOT (.) usuwa wszystkie wyniki znajdujące się w zbiorze tuż po operatorze minus („-”).

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 powyżej użyto operatora logicznego AND, aby wskazać, że wyniki nie powinny być zapisywane w języku francuskim ani włoskim. W zależności od rozmieszczenia nawiasów w zapytaniu możesz użyć operatora logicznego AND lub operatora logicznego OR do wyrażenia tego zapytania. Dzieje się tak, ponieważ dokument jest napisany w języku francuskim, a nie po włosku. Dlatego wyrażenie logiczne musi wskazywać, że dokument nie jest napisany w języku francuskim a nie jest w języku włoskim.


Wartość logiczna LUB [|]
Opis

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

Przykłady

W tym przykładzie zwracane są wszystkie wyniki napisane w języku chińskim tradycyjnym lub uproszczonym:
lr=lang_zh-TW|lang_zh-CN

W tym przykładzie wymagane są wszystkie wyniki, które nie są napisane w języku francuskim ani włoskim. Zauważ, że nawiasy znajdują się w innej lokalizacji niż w przykładowym zapytaniu z operatorem Boolean AND:
lr=-(lang_fr|lang_it)


Nawiasy logiczne [()]
Opis

Ten operator umożliwia sprawdzenie, czy wszystkie hasła w najbardziej wewnętrznym zestawie nawiasów są sprawdzane przed uwzględnieniem haseł spoza nawiasów. Aby zmienić kolejność wykluczania haseł, możesz użyć nawiasów.

Przykłady

Przykład operatora NOT [-] pokazuje taką strukturę 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, które nie są napisane w języku francuskim ani włoskim. W tym drugim przykładzie użyto operatora OR, a nie operatora 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 prawidłowo 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, a niektóre znaków specjalnych do żądania funkcji wyszukiwania. Dlatego należy zmieniać znaczenie wszystkich znaków niealfanumerycznych w wartościach parametrów wyszukiwania.

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

Znak Kodowanie
szesnastkowe
$ %24
- %2 d
_ %5F
. %2E
+ %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 ze zmianą znaczenia w adresie URL
cios&judy cios%26judy
O'Reilly Reilly

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

Kompresowanie wyników

Google może kompresować wyniki wyszukiwania za pomocą kompresji HTTP gzip. Jeśli możesz zdekompresować zawartość skompresowaną za pomocą algorytmu gzip, możesz uzyskać oszczędności przepustowości rzędu 50–70%, co może skrócić czas odpowiedzi.

Aby poprosić Google o zwrócenie wyników w formacie skompresowanym, dodaj do żądania wyszukiwania HTTP nagłówek HTTP Accept-Encoding w ten sposób:

Accept-Encoding: gzip

Jeśli Google zwraca 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 Google nie skompresował wyników.

To zachowanie jest określone w standardzie HTTP. Więcej informacji o stosowaniu 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 jednej z 2 pierwszych kolumn tej tabeli. Wartości w pierwszej kolumnie to pseudonimy schematów kodowania, a wartości w drugiej kolumnie to standardowe nazwy schematów kodowania. Google zwraca nazwy standardowe w wynikach XML, 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 UE – Korea Południowa koreański
Sisi 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 ponad 80 języków. Domyślnym językiem interfejsu jest angielski. Na poniższej liście wymieniono 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 h
czeski cs
duński da
niderlandzki nl
angielski angielski
esperanto Eo
estoński et
farerski fo
fiński fi
francuski fr
fryzyjski zwięzłe
galicyjski gl
gruziński ka
niemiecki de
grecki el
gudżarati gu
hebrajski; iw
hindi hi
węgierski hu
islandzki jest
indonezyjski id
interlingua IA
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
Malajam ml
maltański mt
marathi mr
nepalski ne
norweski nie
norweski (nynorsk) nn
oksytański oc
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
tagalski tl
tamilski ta
telugu te
tajski th
tigrinya ti
turecki tr
ukraiński uk
urdu ur
uzbecki uz
wietnamski vi
walijski cy
xhosa x wys.
zulu zu

Wartości kolekcji 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_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 w poszczególnych krajach

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

Kraj Nazwa kolekcji 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 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 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
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
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

W tabeli poniżej znajdziesz dwuliterowe kody krajów, których można użyć 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 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 DSM
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 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 JZ
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ąc
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 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
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 odb
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
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 tk
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 ech
Jemen taa
Zambia ZM
Zimbabwe ZW