Dokumentacja API JSON

Wartość logiczna LUB wyszukiwanie [ OR ]
Opis

Zapytanie OR pobiera dokumenty zawierające 1 z serii (2 lub więcej) haseł. Aby użyć wyszukiwanego hasła OR, musisz wstawić wyszukiwane hasło OR wielkimi literami między poszczególne hasła w serii.

Możesz też użyć parametru żądania „as_oq” (np. „as_oq=London+Paryż”), aby wyszukać dowolne hasło w zestawie.

Uwaga: jeśli w żądaniu wyszukiwania znajdzie się hasło „London+LUB+Paryż”, w wynikach wyszukiwania pojawią się dokumenty zawierające co najmniej 1 z tych 2 słów. W niektórych przypadkach dokumenty w wynikach wyszukiwania mogą zawierać oba te słowa.
Przykłady

Wyszukaj Londyn lub Paryż:

Dane wejściowe użytkownika:london OR paris Zapytanie:q=london+OR+paris

Wyszukaj wakacje i Londyn albo Paryż:

Wyszukiwane hasło:q=vacation+london+OR+paris

Wyszukaj wakacje i jedno z Londynu, Paryża lub czekoladek:

Wyszukiwane hasło:  q=vacation+london+OR+paris+OR+chocolates

Wyszukaj hasła wakacyjne i czekoladki oraz hasła „Londyn” lub „Paryż”, przy czym czekolada przypisuje najmniejszą wagę:

Wyszukiwane hasło:  q=vacation+london+OR+paris+chocolates

Wyszukaj wakacje, czekoladki i kwiaty w dokumentach, które zawierają też słowa „Londyn” lub „Paryż”:

Wyszukiwane hasło:  q=vacation+london+OR+paris+chocolates+flowers

Wyszukaj wakacje, Londyn albo Paryż, a także czekoladę lub kwiaty:

Wyszukiwane hasło:  q=vacation+london+OR+paris+chocolates+OR+flowers

Operatory logiczne

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

  • cr
  • lr

Definicje operatorów logicznych

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

Wartość logiczna AND [.]
Opis

Operator AND (.) zwraca wyniki znajdujące się w miejscu przecięcia 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 NOT [-]
Opis

Operator NOT (-) usuwa wszystkie wyniki, które znajdują się w kolekcji, 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 OR [|]
Opis

Operator OR (|) zwraca wyniki znajdujące się w kolekcji po lewej stronie lub po prawej stronie operatora pionowej kreski („|”).
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 żą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ść oceniania haseł.
Przykłady

Przykład operatora NOT [-] pokazuje następujący konstrukcja dla wyników żądań, które nie są napisane ani 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 AND, więc trzeba też zmienić lokalizację nawiasów:
lr=-(lang_fr|lang_it)

Prezentacja internacjonalizacji zapytań i wyników

Usługa Google WebSearch umożliwia wyszukiwanie dokumentów w wielu językach. Możesz określić kodowanie znaków, które powinno być używane do interpretowania żądania HTTP i zakodowania odpowiedzi. Możesz też filtrować wyniki, aby uwzględnić tylko dokumenty napisane w określonych językach.

W tych sekcjach omówiono problemy związane z wyszukiwaniem w wielu językach:

Języki interfejsu

Aby określić język interfejsu graficznego, możesz użyć parametru żądania „hl”. Wartość parametru „hl” może mieć wpływ na wyniki wyszukiwania, zwłaszcza w przypadku zapytań międzynarodowych, gdy ograniczenie języka (za pomocą parametru „lr”) nie jest wyraźnie określone. W takich przypadkach parametr „hl” może promować wyniki wyszukiwania w tym samym języku co język wprowadzania użytkownika.

Zalecamy jawne ustawienie parametru „hl” w wynikach wyszukiwania, aby zapewnić, że Google wybiera wyniki wyszukiwania najwyższej jakości dla każdego zapytania.

Pełną listę prawidłowych wartości parametru „hl” znajdziesz w sekcji Obsługiwane języki interfejsu.

Chiński uproszczony i chiński tradycyjny to 2 odmiany pisma chińskiego. To samo pojęcie może być inaczej pisane w poszczególnych wariantach. Przy uwzględnieniu zapytania w jednym z wariantów usługa Google WebSearch może zwrócić wyniki zawierające strony w obu wariantach.

Aby skorzystać z tej funkcji:

  1. Ustaw parametr żądania „c2coff” na 0
    i
  2. Wykonaj jedną z tych czynności:
    • Nie ustawiaj parametru żądania „lr”
      lub
    • Ustaw parametr żądania „lr” na lr=lang_zh-TW|lang_zh-CN.

Poniższy przykład pokazuje parametry zapytania, które należy umieścić w żądaniu wyników w języku chińskim uproszczonym i tradycyjnym. (pamiętaj, że w tym przykładzie nie podano dodatkowych informacji, takich jak „klient”).

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

Filtrowanie wyników

Google WebSearch udostępnia kilka sposobów filtrowania wyników wyszukiwania:

Automatyczne filtrowanie wyników wyszukiwania

Starając się wyświetlać jak najlepsze wyniki wyszukiwania, Google stosuje 2 metody, aby automatycznie odfiltrowywać wyniki wyszukiwania, które są na ogół niepożądane:

  • Powielone treści – jeśli wiele dokumentów zawiera te same informacje, w wynikach wyszukiwania pojawi się tylko najtrafniejszy dokument z tego zestawu.

  • Grupowanie hostów – jeśli z tej samej witryny pochodzi wiele wyników wyszukiwania, Google może nie wyświetlać wszystkich wyników z tej witryny lub wyświetlać wyniki niższe niż
    w rankingu wyników.

Zalecamy pozostawienie tych filtrów włączonych w przypadku typowych zapytań wyszukiwania, ponieważ znacznie poprawiają one jakość większości wyników wyszukiwania. Te automatyczne filtry możesz jednak pominąć, ustawiając w żądaniu wyszukiwania parametr zapytania „filter” na 0.

Filtrowanie treści dla dorosłych przy użyciu filtra SafeSearch

Wielu klientów Google nie chce wyświetlać wyników wyszukiwania witryn zawierających treści dla dorosłych. Za pomocą filtra SafeSearch możesz wyszukiwać i eliminować wyniki wyszukiwania zawierające treści dla dorosłych. Filtry Google używają zastrzeżonej technologii do sprawdzania słów kluczowych, wyrażeń i adresów URL. Żaden filtr nie jest skuteczny w 100%, ale filtr SafeSearch usuwa z wyników wyszukiwania większość treści dla dorosłych.

W Google dbamy o to, aby filtr SafeSearch był stale aktualny i kompleksowy, stale indeksując sieć i uwzględniając aktualizacje na podstawie sugestii użytkowników.

Za pomocą parametru zapytania „safe” możesz dostosować stopień filtrowania wyników pod kątem treści dla dorosłych. W tabeli poniżej znajdziesz informacje o ustawieniach filtra SafeSearch i jego wpływie na wyniki wyszukiwania:

Poziom filtra SafeSearch Opis
high Włącza bardziej rygorystyczną wersję filtra SafeSearch.
medium Blokuje strony zawierające pornografię i inne treści o charakterze jednoznacznie seksualnym.
off Treści dla dorosłych nie są odfiltrowywane z wyników wyszukiwania.

* Domyślne ustawienie filtra SafeSearch jest wyłączone.

Wartości międzynarodowe

Obsługiwane języki interfejsu

Google obsługuje ponad 80 języków. 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 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 hr
czeski cs
duński da
niderlandzki nl
angielski en
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 is
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 no
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
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 zbierania danych wg kraju

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

Kraj Nazwa kolekcji dotyczącej 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 (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
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
Wyspy 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 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 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 Republiki Chińskiej) 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
Tuvalu 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 as
Andora ad
Angola ao
Anguilla ai
Antarktyda aq
Antigua i Barbuda ag
Argentyna ar
Armenia am
Aruba aw
Australia au
Austria at
Azerbejdżan az
Bahamy bs
Bahrajn bh
Bangladesz bd
Barbados bb
Białoruś by
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) cc
Kolumbia co
Komory km
Kongo cg
Demokratyczna Republika Konga cd
Wyspy Cooka ck
Kostaryka cr
Wybrzeże Kości Słoniowej ci
Chorwacja hr
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 er
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 gn
Gwinea Bissau gw
Gujana gy
Haiti ht
Wyspy Heard i McDonalda hm
Stolica Apostolska (Watykan) va
Honduras hn
Hongkong hk
Węgry hu
Islandia is
Indie in
Indonezja id
Iran ir
Irak iq
Irlandia ie
Izrael il
Włochy it
Jamajka jm
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 mo
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 na
Nauru nr
Nepal np
Holandia nl
Antyle Holenderskie an
Nowa Kaledonia nc
Nowa Zelandia nz
Nikaragua ni
Niger ne
Nigeria ng
Niue nu
Norfolk nf
Mariany Północne mp
Norwegia no
Oman om
Pakistan pk
Palau pw
Palestyna ps
Panama pa
Papua-Nowa Gwinea pg
Paragwaj py
Peru pe
Filipiny ph
Wyspy Pitcairn pn
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 pm
Saint Vincent i Grenadyny vc
Samoa ws
San Marino sm
Wyspy Świętego Tomasza i Książęca st
Arabia Saudyjska sa
Senegal sn
Serbia i Czarnogóra cs
Seszele sc
Sierra Leone sl
Singapur sg
Słowacja sk
Słowenia si
Wyspy Salomona sb
Somalia so
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 Republiki Chińskiej) tw
Tadżykistan tj
Tanzania tz
Tajlandia th
Timor Wschodni tl
Togo tg
Tokelau tk
Wyspy Tonga to
Trynidad i Tobago tt
Tunezja tn
Turcja tr
Turkmenistan tm
Turks i Caicos tc
Tuvalu tv
Uganda ug
Ukraina ua
Zjednoczone Emiraty Arabskie ae
Wielka Brytania uk
Stany Zjednoczone us
Dalekie Wyspy Mniejsze Stanów Zjednoczonych um
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 ye
Zambia zm
Zimbabwe zw