JSON API 參考資料

布林值「或」搜尋 [OR ]
說明

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

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

注意：如果搜尋要求指定查詢「倫敦+OR+巴黎」，搜尋結果就會包含至少含有這兩個字詞之一的文件。在某些情況下，搜尋結果中的文件可能會同時包含這兩個字詞。
例子

搜尋倫敦或巴黎：

使用者輸入：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 運算子 (.) 會傳回左側集合中的結果，或直立線運算子右側的集合 (「|」) 中的結果。
例子

以下範例會傳回所有以簡體中文或繁體中文撰寫的結果：
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 的安全搜尋設定，以及這些設定對搜尋結果的影響：

安全搜尋層級 說明
高 啟用更嚴格的安全搜尋功能。
媒介 封鎖含有色情內容和其他煽情露骨內容的網頁。
關閉 不會從搜尋結果中過濾掉成人內容。

* 安全搜尋設定預設為關閉。

如果您已啟用安全搜尋，但在搜尋結果中發現含有令人反感內容的網站，請透過電子郵件將該網站的網址傳送至 safesearch@google.com，我們會著手調查該網站。

國際價值

支援的介面語言

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

顯示語言 hl 參數值
南非荷蘭文 af
阿爾巴尼亞文 sq
阿姆哈拉文 sm
阿拉伯文 ar
亞塞拜然文 az
巴斯克文 eu
白俄羅斯語 be
孟加拉文 bn
比哈爾文 bh
波士尼亞文 bs
保加利亞文 bg
加泰隆尼亞文 ca
中文 (簡體) zh-CN
中文 (繁體) zh-TW
克羅埃西亞文 時
捷克文 cs
丹麥文 da
荷蘭文 nl
英文 en
世界語 eo
愛沙尼亞文 et
法羅語 二
芬蘭文 fi
法文 fr
弗利然文 fy
加里西亞語 gl
喬治亞文 ka
德文 de
希臘文 el
古吉拉特文 gu
希伯來文 iw
北印度文 hi
匈牙利文 hu
冰島文 為
印尼文 id
國際文 亞洲
愛爾蘭文 ga
義大利文 it
日文 ja
爪哇文 jw
卡納達文 kn
韓文 ko
拉丁文 la
拉脫維亞文 lv
立陶宛文 lt
馬其頓文 mk
馬來文 毫秒
馬來文 ml
馬耳他文 mt
馬拉地文 mr
尼泊爾文 ne
挪威文 否
挪威文 (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
美屬薩摩亞 CANNOT TRANSLATE
安道爾 廣告
安哥拉 ao
安吉拉 ai
南極洲 Aq
安地卡及巴布達 ag
阿根廷 ar
亞美尼亞 am
阿魯巴 aw
澳洲 au
奧地利 at
亞塞拜然 az
巴哈馬 bs
巴林 bh
孟加拉 bd
巴貝多 bb
白俄羅斯 執行者：
比利時 be
貝里斯 Bz
貝南 BJ
百慕達 BM
不丹 bt
玻利維亞 bo
波士尼亞與赫塞哥維納 ba
波札那 bw
布威島 BV
巴西 br
英屬印度洋領地 io
汶萊 bn
保加利亞 bg
布吉納法索 bf
蒲隆地 商業智慧 (BI)
柬埔寨 kh
喀麥隆 公分
加拿大 ca
維德角 cv
開曼群島 ky
中非共和國 cf
查德 td
智利 cl
中國 cn
聖誕島 cx
科科斯 (基林) 群島 副本收件人
哥倫比亞 co
葛摩 公里
剛果 cG
剛果民主共和國 cd
庫克群島 ck
哥斯大黎加 cr
象牙海岸 ci
克羅埃西亞 時
古巴 cu
賽普勒斯 cy
捷克共和國 cz
丹麥 dk
吉布地 DJ
多米尼克 dm 鍵
多明尼加共和國 do
厄瓜多 ec
埃及 eg
薩爾瓦多 sv
赤道幾內亞 公克
厄利垂亞 個地球半徑
愛沙尼亞 ee
衣索比亞 et
福克蘭群島 (馬爾維納斯) FK
法羅群島 二
斐濟 FJ
芬蘭 fi
法國 fr
法屬圭亞那 的設定
法屬波里尼西亞 pf
法屬南部領地 tf
加彭 ga
甘比亞 gm
喬治亞 ge
德國 de
迦納 gh
直布羅陀 Gi
希臘 gr
格陵蘭 gl
格瑞那達 gd
瓜地洛普 gp
關島 gu
瓜地馬拉 gt
幾內亞 gn
幾內亞比索 gw
蓋亞那 朝鮮
海地 ht
赫德島和麥克唐納群島 小時
教廷 (梵蒂岡) va
宏都拉斯 hn
香港 hk
匈牙利 hu
冰島 為
印度 在
印尼 id
伊朗伊斯蘭共和國 愛爾蘭
伊拉克 iq
愛爾蘭 ie
以色列 il
義大利 it
牙買加 jm
日本 jp
約旦 jo
哈薩克 kz
肯亞 ke
吉里巴斯 ki
朝鮮民主主義人民共和國 (北韓) kp
大韓民國 kr
科威特 kw
吉爾吉斯 公斤
寮國 la
拉脫維亞 lv
黎巴嫩 英磅
賴索托 ls
賴比瑞亞 lr
利比亞 ly
列支敦斯登 li
立陶宛 lt
盧森堡 lu
澳門 月
馬其頓 mk
馬達加斯加 毫克
馬拉威 mw
馬來西亞 my
馬爾地夫 mv
馬利 ml
馬爾他 mt
馬紹爾群島 mh
馬丁尼克 mq
茅利塔尼亞 mr
模里西斯 mu
馬約特島 yt
墨西哥 mx
密克羅尼西亞聯邦 fm
摩爾多瓦共和國 md
摩納哥 Mc
蒙古 mn
蒙哲臘 毫秒
摩洛哥 ma
莫三比克 mz
緬甸 mm
納米比亞 不適用
諾魯 NR
尼泊爾 np
荷蘭 nl
荷屬安地列斯 一個
新喀里多尼亞 nc
紐西蘭 nz
尼加拉瓜 ni
尼日 ne
奈及利亞 ng
紐埃 努
諾福克島 NF
北馬里亞納群島 mp
挪威 否
阿曼 om
巴基斯坦 pk
帛琉 pw
巴勒斯坦佔領區 ps
巴拿馬 pa
巴布亞紐幾內亞 第 頁
巴拉圭 py
秘魯 pe
菲律賓 ph
皮特肯 pn
波蘭 pl
葡萄牙 pt
波多黎各 pr
卡達 qa
留尼旺 Re 鍵
羅馬尼亞 ro
俄羅斯聯邦 ru
盧安達 rw
聖赫勒拿 sh
聖克里斯多福及尼維斯 kn
聖露西亞 lc
聖皮埃與密克隆群島 下午
聖文森與格瑞那丁 vc
薩摩亞 ws
聖馬利諾 sm
聖多美普林西比 st
沙烏地阿拉伯 sa
塞內加爾 sn
塞爾維亞蒙特內哥羅 cs
塞席爾 sc
獅子山 sl
新加坡 sg
斯洛伐克 sk
斯洛維尼亞 si
索羅門群島 sb
索馬利亞 超級輪
南非 za
南喬治亞與南桑威奇群島 gs
西班牙 es
斯里蘭卡 奶
蘇丹 sd
蘇利南 sr
挪威屬斯瓦巴及尖棉 Sj
史瓦帝尼 sz
瑞典 se
瑞士 ch
敘利亞阿拉伯共和國 sy
台灣 tw
塔吉克 TJ
坦尚尼亞聯合共和國 tz
泰國 th
東帝汶 tl
多哥 tg
托克勞群島 tk
東加 到
千里達與托巴哥 tt
突尼西亞 tn
土耳其 tr
土庫曼 tm
土克凱可群島 tc
吐瓦魯 電視
烏干達 ug
烏克蘭 ua
阿拉伯聯合大公國 ae
英國 uk
美國 us
美屬邊疆群島 呃
烏拉圭 uy
烏茲別克 uz
萬那杜 vu
委內瑞拉 ve 鍵
越南 vn
英屬維京群島 vg
美屬維京群島 vi
瓦利斯群島和富圖那群島 wf
西撒哈拉 eh
葉門 葉子
尚比亞 zm
辛巴威 ZW