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)

注意：您可能已註意到 第二個範例使用「布林值」 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」要求參數至 找出圖形介面的語言。「hl」參數值可能會影響搜尋結果，尤其是在 未明確指定語言限制 (使用「lr」參數) 時的國際查詢。因此 範例為「hl」參數可能會提高搜尋結果 採用與使用者輸入語言相同的語言

建議您明確地將「hl」設為參數 以確保 Google 能從搜尋結果中 也就是每一筆查詢的結果

請參閱支援的介面 「Languages」(語言) 部分查看「hl」的有效值完整清單參數。

簡體中文和繁體中文是兩種書寫變體 中文版本相同的概念可能會以不同方式寫成 每個變化版本如果使用其中一個變體的查詢，Google WebSearch 服務可以傳回同時包含 子類

這項功能的使用需求如下：

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

以下範例說明如何在結果請求中加入的查詢參數 簡體中文和繁體中文(請注意，其他必要資訊， 不包含為「client」)。

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

篩選結果

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

自動篩選搜尋結果

為了盡可能提供最準確的搜尋結果，Google 會運用兩種技巧，自動篩除 通常視為不理想：

  • 重複的內容：如有多份文件內含 生成的內容，那麼只有其中最相關的文件 並顯示在你的搜尋結果中

  • Host Crowding (主機群數)：如果搜尋結果與您的網站相符， Google 可能不會顯示該網站的所有搜尋結果， 顯示低於
    的結果 而不是原本情況

建議你為一般搜尋要求保持啟用這些篩選器 因為篩選器可大幅提升多數搜尋作業的品質 也就是預測結果不過，您可以設定「篩選器」，略過這些自動篩選器。將查詢參數傳送至 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