JSON API 參考資料

布林值或搜尋 [ OR ]
說明

OR 查詢字詞會擷取內含一系列 (兩個以上) 查詢字詞的其中一個文件。如要使用 OR 查詢字詞，請在系列中的每個字詞之間插入以大寫字母輸入的搜尋字詞 OR。

您也可以使用「as_oq」要求參數 (例如「as_oq=London+Paris」) 提交一組字詞的搜尋字詞。

注意：如果搜尋要求指定查詢「London+OR+Paris」，搜尋結果將包含至少包含這兩個字詞中的其中一個文件。在某些情況下，搜尋結果中的文件可能同時包含這兩個字詞。
例子

搜尋倫敦或巴黎：

使用者輸入內容：london OR paris 查詢字詞：q=london+OR+paris

搜尋度假，以及倫敦或巴黎：

查詢字詞：q=vacation+london+OR+paris

搜尋度假以及倫敦、巴黎或巧克力：

查詢字詞：  q=vacation+london+OR+paris+OR+chocolates

搜尋「假期」和「巧克力」以及「倫敦」或「巴黎」，而巧克力的重量最低：

查詢字詞：  q=vacation+london+OR+paris+chocolates

在同時含有倫敦或巴黎的文件中搜尋假期、巧克力和花卉：

查詢字詞：  q=vacation+london+OR+paris+chocolates+flowers

搜尋假期以及倫敦或巴黎之一，並搜尋巧克力或花卉的其中之一：

查詢字詞：  q=vacation+london+OR+paris+chocolates+OR+flowers

布林運算子

您可以在下列參數的值中使用布林運算子：

  • cr
  • lr

布林值運算子定義

注意：參數值不得包含空格。

布林值 AND [.]
說明

AND 運算子 (.) 會傳回位於「.」運算子左右集合交集的結果。
例子

以下範例會移除法文或義大利文的所有結果：
lr=(-lang_fr).(-lang_it)

布林值 NOT [-]
說明

NOT 運算子 (-) 會移除集合裡的所有結果，緊接在減號 (「-」) 運算子後方。
例子

以下範例會移除所有使用法文的搜尋結果：
lr=-lang_fr

以下範例會移除法文或義大利文的所有結果：
lr=(-lang_fr).(-lang_it)

注意：您可能已註意到，上述第二個範例使用了 Boolean AND 運算子，指定結果不應以法文或義大利文撰寫。視查詢中括號的位置而定，您可以使用 Boolean AND 運算子或 Boolean OR 運算子來表示這個查詢。這是因為如果文件是以法文撰寫，「不是」義大利文。因此，您的布林陳述式必須表示文件並非以法文撰寫，「且」文件並非以義大利文撰寫。

布林值 OR [|]
說明

OR 運算子 (|) 會傳回左側集合或管道 (「|」) 運算子右側的集合中的結果。
例子

以下範例會傳回所有以簡體中文或繁體中文撰寫的結果：
lr=lang_zh-TW|lang_zh-CN

以下範例會要求不是以法文或義大利文撰寫的所有結果；請注意，它會將括號放在不同於「Boolean AND」運算子查詢範例的位置：
lr=-(lang_fr|lang_it)

布林值括號 [()]
說明

此運算子可讓您確保系統先評估最內括號組合中的所有字詞，再評估括號外的字詞。您可以使用括號調整字詞的評估順序。
例子

NOT [-] 運算子的範例會顯示非以法文或義大利文撰寫的要求結果：
lr=(-lang_fr).(-lang_it)

OR (|) 運算子的範例也顯示了非以法文撰寫的結果要求。由於第二個範例使用 OR 運算子，而非 AND 運算子，因此也必須變更括號的位置：
lr=-(lang_fr|lang_it)

國際化查詢與結果呈現

Google WebSearch 服務可讓您搜尋多種語言的文件。您可以指定應用於解譯 HTTP 要求及為回應編碼的字元編碼。 您也可以篩選搜尋結果，只顯示特定語言的文件。

下列各節討論使用多種語言搜尋的相關問題：

介面語言

您可以使用「hl」要求參數辨別圖形介面的語言。如果您未明確指定語言限制 (使用「lr」參數) 時，「hl」參數值可能會影響搜尋結果，尤其是對於國際查詢。在這種情況下，「hl」參數可能會宣傳與使用者輸入語言相同的搜尋結果。

建議您明確設定搜尋結果中的「hl」參數，確保 Google 會為每筆查詢選取最高品質的搜尋結果。

如需「hl」參數有效值的完整清單，請參閱支援的介面語言一節。

簡體中文和繁體中文是中文的兩種書寫版本。同一個概念在各個變化版本中可能以不同方式編寫。只要查詢其中一個變體中的查詢，Google WebSearch 服務就會傳回含有兩個變體網頁的結果。

如要使用這項功能，請按照下列步驟操作：

  1. 將「c2coff」要求參數設為 0
    ，並
  2. 執行下列任一操作：
    • 請勿設定「lr」要求參數
      或
    • 將「lr」要求參數設為 lr=lang_zh-TW|lang_zh-CN

以下範例顯示了簡體和繁體中文結果要求中可加入的查詢參數。(請注意，範例未包含其他必要資訊，例如「用戶端」)。

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

篩選結果

Google WebSearch 提供多種篩選搜尋結果的方式：

自動篩選搜尋結果

為盡可能提供最準確的搜尋結果，Google 會使用以下兩種技術，自動篩選一般視為不適當的搜尋結果：

  • 重複的內容：如有多份文件內含相同的資訊，則搜尋結果只會納入其中最相關的文件。

  • 主機密集占位 (Host Crowding)：如有多筆搜尋結果來自同一個網站，Google 可能不會顯示該網站的所有搜尋結果，或排名可能會低於
    。

由於這類篩選器可以大幅提高多數搜尋結果的品質，因此建議您針對一般搜尋要求啟用這些篩選器。不過，您可以在搜尋要求中將「filter」查詢參數設為 0，藉此略過這些自動篩選器。

使用「安全搜尋」過濾成人內容

許多 Google 客戶不希望針對含有成人內容的網站顯示搜尋結果。您可以使用安全搜尋篩選器，過濾掉含有成人內容的搜尋結果，並消除這些結果。 Google 的篩選器運用獨家技術來檢查關鍵字、詞組和網址。雖然沒有任何篩選器能做到滴水不漏，但「安全搜尋」能夠從搜尋結果中移除絕大多數的成人內容。

Google 會持續檢索網路，並整合使用者建議更新，致力確保安全搜尋功能提供最即時、最全面的防護。

您可以使用「安全」查詢參數，調整 Google 篩選成人內容搜尋結果的程度。 下表說明 Google 的安全搜尋設定，以及這些設定對搜尋結果的影響：

安全搜尋等級 說明
high 提供更嚴格的安全搜尋版本。
medium 封鎖含有色情內容和其他煽情露骨內容的網頁。
off 而且不過濾搜尋結果中的成人內容。

*安全搜尋功能預設為關閉。

國際價值

支援的介面語言

Google 支援超過 80 種語言。介面語言的預設語言為英文。以下清單列出 Google 支援的所有介面語言。

顯示語言 hl 參數值
南非荷蘭文 af
阿爾巴尼亞文 sq
阿姆哈拉文 sm
阿拉伯文 ar
亞塞拜然文 az
巴斯克文 eu
白俄羅斯語 be
孟加拉文 bn
比哈爾文 bh
波士尼亞文 bs
保加利亞文 bg
加泰隆尼亞文 ca
中文 (簡體) zh-CN
中文 (繁體) zh-TW
克羅埃西亞文 hr
捷克文 cs
丹麥文 da
荷蘭文 nl
英文 en
世界語 eo
愛沙尼亞文 et
法羅語 fo
芬蘭文 fi
法文 fr
弗利然文 fy
加里西亞語 gl
喬治亞文 ka
德文 de
希臘文 el
古吉拉特文 gu
希伯來文 iw
北印度文 hi
匈牙利文 hu
冰島文 is
印尼文 id
世界語 ia
愛爾蘭文 ga
義大利文 it
日文 ja
爪哇文 jw
卡納達文 kn
韓文 ko
拉丁文 la
拉脫維亞文 lv
立陶宛文 lt
馬其頓文 mk
馬來文 ms
馬來文 ml
馬耳他文 mt
馬拉地文 mr
尼泊爾文 ne
挪威文 no
挪威文 (Nynorsk) nn
歐西坦語 oc
波斯文 fa
波蘭文 pl
葡萄牙文 (巴西) pt-BR
葡萄牙文 (葡萄牙) pt-PT
旁遮普文 pa
羅馬尼亞文 ro
俄文 ru
蘇格蘭的蓋爾文 gd
塞爾維亞文 sr
錫蘭語 si
斯洛伐克文 sk
斯洛維尼亞文 sl
西班牙文 es
蘇丹文 su
史瓦西里文 sw
瑞典文 sv
塔加路文 tl
泰米爾文 ta
泰盧固文 te
泰文 th
蒂格里亞文 ti
土耳其文 tr
烏克蘭語 uk
烏都文 ur
烏玆別克文 uz
越南文 vi
威爾斯文 cy
柯薩文 xh
祖魯文 zu

國家/地區集合值

您可以使用下列值，透過「cr」查詢參數指定國家/地區篩選條件：

國家/地區 國家/地區集合名稱
阿富汗 countryAF
阿爾巴尼亞 countryAL
阿爾及利亞 countryDZ
美屬薩摩亞 countryAS
安道爾 countryAD
安哥拉 countryAO
安圭拉 countryAI
南極洲 countryAQ
安地卡及巴布達 countryAG
阿根廷 countryAR
亞美尼亞 countryAM
阿魯巴 countryAW
澳洲 countryAU
奧地利 countryAT
亞塞拜然 countryAZ
巴哈馬 countryBS
巴林 countryBH
孟加拉 countryBD
巴貝多 countryBB
白俄羅斯 countryBY
比利時 countryBE
貝里斯 countryBZ
貝南 countryBJ
百慕達 countryBM
不丹 countryBT
玻利維亞 countryBO
波士尼亞與赫塞哥維納 countryBA
波札那 countryBW
布威島 countryBV
巴西 countryBR
英屬印度洋領地 countryIO
汶萊 countryBN
保加利亞 countryBG
布吉納法索 countryBF
蒲隆地 countryBI
柬埔寨 countryKH
喀麥隆 countryCM
加拿大 countryCA
維德角 countryCV
開曼群島 countryKY
中非共和國 countryCF
查德 countryTD
智利 countryCL
中國 countryCN
聖誕島 countryCX
科克斯 (基靈) 群島 countryCC
哥倫比亞 countryCO
葛摩 countryKM
剛果 countryCG
剛果民主共和國 countryCD
庫克群島 countryCK
哥斯大黎加 countryCR
象牙海岸 countryCI
克羅埃西亞 (Hrvatska) countryHR
古巴 countryCU
賽普勒斯 countryCY
捷克共和國 countryCZ
丹麥 countryDK
吉布地 countryDJ
多米尼克 countryDM
多明尼加共和國 countryDO
東帝汶 countryTP
厄瓜多爾 countryEC
埃及 countryEG
薩爾瓦多 countrySV
赤道幾内亞 countryGQ
厄利垂亞 countryER
愛沙尼亞 countryEE
衣索比亞 countryET
歐盟 countryEU
福克蘭群島 (馬爾維納斯) countryFK
法羅群島 countryFO
斐濟 countryFJ
芬蘭 countryFI
法國 countryFR
法屬美特羅波利坦 countryFX
法屬圭亞那 countryGF
法屬玻里尼西亞 countryPF
法屬南部領地 countryTF
加彭 countryGA
甘比亞 countryGM
喬治亞 countryGE
德國 countryDE
迦納 countryGH
直布羅陀 countryGI
希臘 countryGR
格陵蘭 countryGL
格瑞那達 countryGD
哥德洛普島 countryGP
關島 countryGU
瓜地馬拉 countryGT
幾內亞 countryGN
幾內亞比索 countryGW
蓋亞那 countryGY
海地 countryHT
赫德島和麥克唐納群島 countryHM
教廷 (梵蒂岡) countryVA
宏都拉斯 countryHN
香港 countryHK
匈牙利 countryHU
冰島 countryIS
印度 countryIN
印尼 countryID
伊朗伊斯蘭共和國 countryIR
伊拉克 countryIQ
愛爾蘭 countryIE
以色列 countryIL
義大利 countryIT
牙買加 countryJM
日本 countryJP
約旦 countryJO
哈薩克 countryKZ
肯亞 countryKE
吉里巴斯 countryKI
朝鮮民主主義人民共和國 (北韓) countryKP
大韓民國 (南韓) countryKR
科威特 countryKW
吉爾吉斯 countryKG
寮國 countryLA
拉脫維亞 countryLV
黎巴嫩 countryLB
賴索托 countryLS
賴比瑞亞 countryLR
利比亞 countryLY
列支敦斯登 countryLI
立陶宛 countryLT
盧森堡 countryLU
澳門 countryMO
馬其頓 countryMK
馬達加斯加 countryMG
馬拉威 countryMW
馬來西亞 countryMY
馬爾地夫 countryMV
馬利 countryML
馬爾他 countryMT
馬紹爾群島 countryMH
馬丁尼克 countryMQ
茅利塔尼亞 countryMR
模里西斯 countryMU
馬約特 countryYT
墨西哥 countryMX
密克羅尼西亞聯邦 countryFM
摩爾多瓦共和國 countryMD
摩納哥 countryMC
蒙古 countryMN
蒙哲臘 countryMS
摩洛哥 countryMA
莫三比克 countryMZ
緬甸 countryMM
納米比亞 countryNA
諾魯 countryNR
尼泊爾 countryNP
荷蘭 countryNL
荷屬安地列斯群島 countryAN
新喀里多尼亞 countryNC
紐西蘭 countryNZ
尼加拉瓜 countryNI
尼日 countryNE
奈及利亞 countryNG
紐埃 countryNU
諾福克島 countryNF
北馬利安納群島 countryMP
挪威 countryNO
阿曼 countryOM
巴基斯坦 countryPK
帛琉 countryPW
巴勒斯坦領土 countryPS
巴拿馬 countryPA
巴布亞紐幾內亞 countryPG
巴拉圭 countryPY
秘魯 countryPE
菲律賓 countryPH
皮特康 countryPN
波蘭 countryPL
葡萄牙 countryPT
波多黎各 countryPR
卡達 countryQA
留尼旺島 countryRE
羅馬尼亞 countryRO
俄羅斯聯邦 countryRU
盧安達 countryRW
聖赫勒拿島 countrySH
聖克里斯多福及尼維斯 countryKN
聖露西亞 countryLC
聖皮埃與密克隆 countryPM
聖文森及格瑞那丁 countryVC
薩摩亞 countryWS
聖馬利諾 countrySM
聖多美普林西比 countryST
沙烏地阿拉伯 countrySA
塞內加爾 countrySN
塞爾維亞蒙特內哥羅 countryCS
塞席爾 countrySC
獅子山 countrySL
新加坡 countrySG
斯洛伐克 countrySK
斯洛維尼亞 countrySI
索羅門群島 countrySB
索馬利亞 countrySO
南非 countryZA
南喬治亞與南桑威奇群島 countryGS
西班牙 countryES
斯里蘭卡 countryLK
蘇丹 countrySD
蘇利南 countrySR
冷岸及央棉群島 countrySJ
史瓦帝尼 countrySZ
瑞典 countrySE
瑞士 countryCH
敘利亞阿拉伯共和國 countrySY
台灣 countryTW
塔吉克 countryTJ
坦尚尼亞聯合共和國 countryTZ
泰國 countryTH
多哥 countryTG
托克勞群島 countryTK
東加 countryTO
千里達及托巴哥 countryTT
突尼西亞 countryTN
土耳其 countryTR
土庫曼 countryTM
土克凱可群島 countryTC
吐瓦魯 countryTV
烏干達 countryUG
烏克蘭 countryUA
阿拉伯聯合大公國 countryAE
英國 countryUK
美國 countryUS
美屬離島 countryUM
烏拉圭 countryUY
烏茲別克 countryUZ
萬那杜 countryVU
委內瑞拉 countryVE
越南 countryVN
英屬維京群島 countryVG
美屬維京群島 countryVI
瓦利斯和富圖納群島 countryWF
西撒哈拉 countryEH
葉門 countryYE
南斯拉夫 countryYU
尚比亞 countryZM
辛巴威 countryZW

國家/地區代碼

下表列出可使用兩個字母的國家/地區代碼，做為「gl」參數的值：

國家/地區 國家/地區代碼
阿富汗 af
阿爾巴尼亞 al
阿爾及利亞 dz
美屬薩摩亞 as
安道爾 ad
安哥拉 ao
安圭拉 ai
南極洲 aq
安地卡及巴布達 ag
阿根廷 ar
亞美尼亞 am
阿魯巴 aw
澳洲 au
奧地利 at
亞塞拜然 az
巴哈馬 bs
巴林 bh
孟加拉 bd
巴貝多 bb
白俄羅斯 by
比利時 be
貝里斯 bz
貝南 bj
百慕達 bm
不丹 bt
玻利維亞 bo
波士尼亞與赫塞哥維納 ba
波札那 bw
布威島 bv
巴西 br
英屬印度洋領地 io
汶萊 bn
保加利亞 bg
布吉納法索 bf
蒲隆地 bi
柬埔寨 kh
喀麥隆 cm
加拿大 ca
維德角 cv
開曼群島 ky
中非共和國 cf
查德 td
智利 cl
中國 cn
聖誕島 cx
科克斯 (基靈) 群島 cc
哥倫比亞 co
葛摩 km
剛果 cg
剛果民主共和國 cd
庫克群島 ck
哥斯大黎加 cr
象牙海岸 ci
克羅埃西亞 hr
古巴 cu
賽普勒斯 cy
捷克共和國 cz
丹麥 dk
吉布地 dj
多米尼克 dm
多明尼加共和國 do
厄瓜多 ec
埃及 eg
薩爾瓦多 sv
赤道幾内亞 gq
厄利垂亞 er
愛沙尼亞 ee
衣索比亞 et
福克蘭群島 (馬爾維納斯) fk
法羅群島 fo
斐濟 fj
芬蘭 fi
法國 fr
法屬圭亞那 gf
法屬玻里尼西亞 pf
法屬南部領地 tf
加彭 ga
甘比亞 gm
喬治亞 ge
德國 de
迦納 gh
直布羅陀 gi
希臘 gr
格陵蘭 gl
格瑞那達 gd
哥德洛普島 gp
關島 gu
瓜地馬拉 gt
幾內亞 gn
幾內亞比索 gw
蓋亞那 gy
海地 ht
赫德島和麥克唐納群島 hm
教廷 (梵蒂岡) va
宏都拉斯 hn
香港 hk
匈牙利 hu
冰島 is
印度 in
印尼 id
伊朗伊斯蘭共和國 ir
伊拉克 iq
愛爾蘭 ie
以色列 il
義大利 it
牙買加 jm
日本 jp
約旦 jo
哈薩克 kz
肯亞 ke
吉里巴斯 ki
朝鮮民主主義人民共和國 (北韓) kp
大韓民國 (南韓) kr
科威特 kw
吉爾吉斯 kg
寮國 la
拉脫維亞 lv
黎巴嫩 lb
賴索托 ls
賴比瑞亞 lr
利比亞 ly
列支敦斯登 li
立陶宛 lt
盧森堡 lu
澳門 mo
馬其頓 mk
馬達加斯加 mg
馬拉威 mw
馬來西亞 my
馬爾地夫 mv
馬利 ml
馬爾他 mt
馬紹爾群島 mh
馬丁尼克 mq
茅利塔尼亞 mr
模里西斯 mu
馬約特 yt
墨西哥 mx
密克羅尼西亞聯邦 fm
摩爾多瓦共和國 md
摩納哥 mc
蒙古 mn
蒙哲臘 ms
摩洛哥 ma
莫三比克 mz
緬甸 mm
納米比亞 na
諾魯 nr
尼泊爾 np
荷蘭 nl
荷屬安地列斯群島 an
新喀里多尼亞 nc
紐西蘭 nz
尼加拉瓜 ni
尼日 ne
奈及利亞 ng
紐埃 nu
諾福克島 nf
北馬利安納群島 mp
挪威 no
阿曼 om
巴基斯坦 pk
帛琉 pw
巴勒斯坦自治區 ps
巴拿馬 pa
巴布亞紐幾內亞 pg
巴拉圭 py
秘魯 pe
菲律賓 ph
皮特康 pn
波蘭 pl
葡萄牙 pt
波多黎各 pr
卡達 qa
留尼旺島 re
羅馬尼亞 ro
俄羅斯聯邦 ru
盧安達 rw
聖赫勒拿島 sh
聖克里斯多福及尼維斯 kn
聖露西亞 lc
聖皮埃與密克隆 pm
聖文森及格瑞那丁 vc
薩摩亞 ws
聖馬利諾 sm
聖多美普林西比 st
沙烏地阿拉伯 sa
塞內加爾 sn
塞爾維亞蒙特內哥羅 cs
塞席爾 sc
獅子山 sl
新加坡 sg
斯洛伐克 sk
斯洛維尼亞 si
索羅門群島 sb
索馬利亞 so
南非 za
南喬治亞與南桑威奇群島 gs
西班牙 es
斯里蘭卡 lk
蘇丹 sd
蘇利南 sr
冷岸及央棉群島 sj
史瓦帝尼 sz
瑞典 se
瑞士 ch
敘利亞阿拉伯共和國 sy
台灣 tw
塔吉克 tj
坦尚尼亞聯合共和國 tz
泰國 th
東帝汶 tl
多哥 tg
托克勞群島 tk
東加 to
千里達及托巴哥 tt
突尼西亞 tn
土耳其 tr
土庫曼 tm
土克凱可群島 tc
吐瓦魯 tv
烏干達 ug
烏克蘭 ua
阿拉伯聯合大公國 ae
英國 uk
美國 us
美屬離島 um
烏拉圭 uy
烏茲別克 uz
萬那杜 vu
委內瑞拉 ve
越南 vn
英屬維京群島 vg
美屬維京群島 vi
瓦利斯和富圖納群島 wf
西撒哈拉 eh
葉門 ye
尚比亞 zm
辛巴威 zw