XML API 參考資料附錄

布林值運算子

您可以在下列值中使用布林值運算子:

布林運算子定義

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

布林值 AND [.]
說明

AND 運算子 (.) 會將集合中的交集結果傳回至 "." 運算子的任一邊。

範例

這個範例會移除使用法文或義大利文的所有結果:
lr=(-lang_fr).(-lang_it)


布林值 NOT [-]
說明

NOT 運算子 (.) 會移除集合後所有位於減號 (-) 運算子的結果。

範例

這個範例會移除法文的所有結果:
lr=-lang_fr

這個範例會移除使用法文或義大利文的所有結果:
lr=(-lang_fr).(-lang_it)

注意:您可能會注意到,上述第二個範例使用布林 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)


網址逸出

如要提出 HTTP 搜尋要求,您必須遵循下列慣例,讓 Google 能正確翻譯您的 HTTP 要求並產生適當的回應。

HTTP 網址結構定義指定 HTTP 網址要求只能包含特定字元:

  • 英數字元 (a-z、A-Z、0-9)
  • 特殊字元: $ - _ 。 | + !* ' ( )
  • 保留的字元: ; / ? : @ = &

Google 會使用保留字元將網址解碼,並使用一些特殊字元來要求搜尋功能。因此,您必須 將搜尋參數值中所有的非英數字元都逸出。

如要將網址逸出,請將每個空白字元序列轉換成單一「+」(加號),並將任何其他非英數字元轉換成代表字元值的十六進位編碼。下表中所列的特殊及保留字元的十六進位編碼。每個字元都應在要求參數值中逸出網址。

字元 十六進位
編碼
$ %24
- %2D 日
_ %5 樓
. %2E 列
+ %20 億
%21
* %2A
%22
' %27
( %28
) %29
%30 億
/ %2F
? %3F
%3A 分
@ %40
= %3D 班
& %26 個
| %7C

範例

原始字串 網址逸出字串
拳擊 調酒%26judy
歐西利 (O'Reilly) O%27 瑞爾

如要進一步瞭解網址逸出,請前往 W3CIETF 網站。

壓縮結果

Google 可以使用 HTTP gzip 壓縮來壓縮搜尋結果。如果使用 gzip 演算法壓縮壓縮的內容,就能節省 50% 至 70% 的頻寬,進而縮短回應時間。

如果想要求 Google 以壓縮格式傳回結果,請在 HTTP 搜尋要求中加入 HTTP Accept-Encoding 標頭,如下所示:

接受編碼:gzip

如果 Google 使用 gzip 壓縮傳回搜尋結果,傳回的 HTTP 標頭會包含以下這行程式碼:

內容編碼:gzip

注意:如果回應中未顯示 Content-Encoding HTTP 標頭,則 Google 不會壓縮結果。

這項行為是在 HTTP 標準中指定。如要進一步瞭解如何使用 HTTP gzip 壓縮,請參閱該文件。

國際價值

字元編碼配置

下表列出 Google 支援的字元編碼配置。您可以在這個資料表的前兩欄中指派 ieoe 參數的值。第一欄中的值是編碼配置的暱稱;第二欄的值是編碼架構的標準名稱。Google 會在 XML 結果中傳回標準名稱,而且標準名稱適合在文件的 HTTP Content-type 標頭中使用。

Google 名稱 編碼 相關的支援語言
latin1 ISO-8859-1 西歐 (加泰隆尼亞文、丹麥文、荷蘭文、英文、芬蘭文、法文、德文、印尼文、義大利文、挪威文、葡萄牙文、西班牙文、瑞典文)
latin2 ISO-8859-2 東歐 (克羅埃西亞文、捷克文、匈牙利文、波蘭文、羅馬尼亞文、塞爾維亞文、斯洛伐克文、斯洛維尼亞文)
latin3 ISO-8859-3  
latin4 ISO-8859-4 波羅的海 (愛沙尼亞文、拉脫維亞文、立陶宛文)
cyrillic ISO-8859-5 保加利亞文、俄文
arabic ISO-8859-6  
希臘 ISO-8859-7 希臘文
hebrew ISO-8859-8 希伯來文
latin5 ISO-8859-9  
latin6 ISO-8859-10 冰島文
euc-jp EUC-JP 日文
euc-kr EUC-KR 韓文
sjis Shift_JIS 日文
big5 Big5 繁體中文
gb GB2312 簡體中文
utf8 UTF-8 全部

支援的介面語言

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
法羅語 fo
芬蘭文 fi
法文 fr
弗利然文 fy
加里西亞語 gl
喬治亞文 ka
德文 de
希臘文 el
古哈拉地語 gu
希伯來文 iw
印度文 hi
匈牙利文 hu
冰島文
印尼文 id
世界語 亞洲
愛爾蘭文 ga
義大利文 it
日文 ja
爪哇語 jw
卡納達文 kn
韓文 ko
拉丁文 la
拉脫維亞文 lv
立陶宛文 lt
馬其頓文 mk
馬來文 ms
馬來丹 ml
馬耳他文 mt
馬拉地文 mr
尼泊爾文 ne
挪威文
挪威文 (Nynorsk)
歐西坦語 10 月
波斯文 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

語言集合值

您可以使用下列值,透過 lr 查詢參數來指定語言篩選器:

語言 lr 參數值
阿拉伯文 語言
保加利亞文 lang_bg
加泰隆尼亞文 lang_ca
中文 (簡體) lang_zh-CN
中文 (繁體) lang_zh-TW
克羅埃西亞文 語言_小時
捷克文 lang_css
丹麥文 lang_da
荷蘭文 lang_nl
繁體中文 lang_en
愛沙尼亞文 lang_et
芬蘭文 lang_fi
法文 朗格
德文 語言
希臘文 語言
希伯來文 語言
匈牙利文 語言
冰島文 語言
印尼文 lang_id
義大利文 語言_內容
日文 lang_ja
韓文 lang_ko
拉脫維亞文 lang_lv
立陶宛文 語言_lt
挪威文 語言_否
波蘭文 lang_pl
葡萄牙文 語言
羅馬尼亞文 語言
俄文 lang_ru
塞爾維亞文 lang_sr
斯洛伐克文 lang_sk
斯洛維尼亞文 lang_sl
西班牙文 語言
瑞典文 lang_sv
土耳其文 語言_tr

國家/地區集合值

您可以使用下列值,透過 cr 查詢參數來指定國家/地區篩選器:

國家/地區 國家/地區集合名稱
阿富汗 國家/地區 AF
阿爾巴尼亞 國家/地區
阿爾及利亞 國家/地區
美屬薩摩亞 國家/地區 AS
安道爾 國家/地區廣告
安哥拉 國家/地區
安吉拉 國家/地區 AI
南極洲 國家/地區 AQ
安地卡及巴布達 國家/地區
阿根廷 國家/地區 AR
亞美尼亞 國家/地區 AM
阿魯巴島 國家/地區 AdWords
澳洲 國家/地區澳洲
奧地利 國家/地區特區
亞塞拜然 國家/地區
巴哈馬 國家/地區 BS
巴林 國家/地區 BH
孟加拉 國家/地區 BD
巴貝多 國家/地區 BB
白俄羅斯 國家/地區 BY
比利時 國家/地區 BE
貝里斯 國家/地區 BZ
貝南 國家/地區 BJ
百慕達 國家/地區 BM
不丹 國家/地區 BT
玻利維亞 國家/地區 BO
波士尼亞與赫塞哥維納 國家/地區 BA
波札那 國家/地區 BW
波維特島 國家/地區 BV
巴西 國家/地區 BR
英屬印度洋領地 國家/地區 IO
汶萊 國家/地區 NN
保加利亞 國家/地區 BG
布吉納法索 國家/地區 BF
蒲隆地 國家/地區商業智慧 (BI)
柬埔寨 國家/地區 (香港)
喀麥隆 CountryCM
加拿大 國家/地區 CA
維德角 國家/地區 CV
開曼群島 國家/地區 (YY)
中非共和國 國家/地區 CF
查德 國家/地區 TD
智利 國家/地區智利
中國 國家/地區 CN
聖誕島 國家/地區 CX
科科斯 (基林) 群島 國家/地區 CC
哥倫比亞 國家/地區 CO
葛摩 國家/地區 KM
剛果 國家/地區 CG
剛果民主共和國 國家 CD
庫克群島 國家/地區 CK
哥斯大黎加 國家/地區罐頭回應
象牙海岸 國家/地區持續整合
克羅埃西亞 (Hrvatska) 國家/地區人資
古巴 國家/地區 CU
賽普勒斯 國家/地區 CY
捷克共和國 國家/地區 CZ
丹麥 國家/地區 KK
吉布地 國家/地區 DJ
多米尼克 國家/地區 DM
多明尼加共和國 國家/地區 DO
東帝汶 國家/地區 TP
厄瓜多 國家/地區 EC
埃及 Country EG
薩爾瓦多 國家/地區 SV
赤道幾內亞 國家/地區總量
厄利垂亞 鄉村
愛沙尼亞 CountryEE
衣索比亞 國家/地區時間
歐盟 國家/地區歐盟
福克蘭群島 (馬爾維納斯) CountryFK
法羅群島 國家/地區 FOFO
斐濟 國家/地區富士
芬蘭 國家/地區 FI
法國 國家/地區法國
法屬美特羅波利坦 國家/地區 FX
法屬圭亞那 國家/地區總算
法屬玻里尼西亞 國家/地區 PF
法屬南部領地 國家/地區 TF
加彭 國家/地區正式發布版
甘比亞 國家/地區總經理
喬治亞 國家/地區 GE
德國 國家/地區
迦納 國家/地區總長
直布羅陀 國家/地區 II
希臘 國家/地區 GR
格陵蘭 CountryGL
格瑞那達 國家/地區
瓜地洛普 國家/地區 GP
關島 國家/地區
瓜地馬拉 國家/地區 GT
幾內亞 國家/地區 NN
幾內亞比索 國家/地區 GW
蓋亞那 國家/地區
海地 國家/地區 HT
赫德島和麥克唐納群島 國家/地區 HM
教廷 (梵蒂岡) 國家/地區 VA
宏都拉斯 國家/地區 NN
香港 國家/地區香港
匈牙利 國家/地區
冰島 國家/地區
印度 國家/地區印度
印尼 countryID
伊朗伊斯蘭共和國 國家/地區 IR
伊拉克 國家/地區專員
愛爾蘭 國家/地區愛爾蘭
以色列 國家/地區 IL
義大利 國家/地區 IT
牙買加 國家/地區 MM
日本 國家/地區 JP
約旦 國家/地區 JO
哈薩克 國家/地區 KZ
肯亞 CountryKE
吉里巴斯 國家/地區
朝鮮民主主義人民共和國 (北韓) 國家/地區 KP
大韓民國 國家/地區韓國
科威特 國家/地區
吉爾吉斯 Country GG
寮國 國家/地區洛杉磯
拉脫維亞 國家/地區 LV
黎巴嫩 國家/地區
賴索托 國家/地區 SS
賴比瑞亞 國家/地區 LR
利比亞 國家/地區
列支敦斯登 國家/地區 LI
立陶宛 國家/地區 TT
盧森堡 國家/地區 LU
澳門 國家/地區 MO
馬其頓 (前南斯拉夫) 國家/地區 MK
馬達加斯加 CountryMG
馬拉威 國家/地區 MW
馬來西亞 國家/地區 MY
馬爾地夫 國家/地區 MV
馬利 國家/地區機器學習
馬爾他 國家/地區 MT
馬紹爾群島 國家/地區 MH
馬丁尼克 國家/地區 MQ
茅利塔尼亞 國家/地區 MR
模里西斯 國家/地區 MU
馬約特 國家/地區 YouTube
墨西哥 國家/地區 MX
密克羅尼西亞聯邦 國家/地區 FM
摩爾多瓦共和國 CountryMD
摩納哥 國家/地區 Merchant Center
蒙古 國家/地區 NN
蒙哲臘 國家/地區 MS
摩洛哥 國家/地區 MAMA
莫三比克 國家/地區 MZ
緬甸 國家/地區 MM
納米比亞 國家/地區 (NA)
諾魯 國家/地區 NR
尼泊爾 國家/地區 NP
荷蘭 國家/地區 NL
荷屬安替列斯 國家/地區
新喀里多尼亞 國家/地區 NC
紐西蘭 國家/地區紐西蘭
尼加拉瓜 國家/地區
尼日 國家/地區
奈及利亞 國家/地區 NGNG
紐埃 國家/地區 NU
諾福克島 國家/地區 NF
北馬利安納群島 國家/地區 MP
挪威 國家/地區 NO
阿曼 國家/地區 OM
巴基斯坦 國家/地區 PK
帛琉 國家/地區 PW
巴勒斯坦領土 國家/地區 PS
巴拿馬 國家/地區 PA
巴布亞紐幾內亞 國家/地區程式輔助保證交易
巴拉圭 國家/地區 PY
秘魯 國家/地區產品專家
菲律賓 國家/地區 PH
皮特肯 國家/地區 NP
波蘭 國家/地區 PL
葡萄牙 國家/地區太平洋時間
波多黎各 國家/地區 PR
卡達 國家/地區品質確保
留尼旺 國家/地區 RE
羅馬尼亞 國家/地區 RO
俄羅斯聯邦 國家/地區俄羅斯
盧安達 國家/地區 WW
聖赫勒拿島 國家/地區 SHSH
聖克里斯多福及尼維斯 國家/地區 NN
聖露西亞 國家/地區 LC
聖皮埃與密克隆群島 國家/地區 PM
聖文森與格瑞那丁 CountryVC
薩摩亞 國家/地區 WS
聖馬利諾 國家/地區 SM
聖多美普林西比 國家/地區 STST
沙烏地阿拉伯 國家/地區 SA
塞內加爾 國家/地區 NN
塞爾維亞蒙特內哥羅 國家/地區 CS
塞席爾 國家/地區 SC
獅子山 國家/地區 SL
新加坡 國家/地區新加坡
斯洛伐克 國家/地區 SK
斯洛維尼亞 國家/地區 SI
索羅門群島 國家/地區銀行
索馬利亞 國家/地區 SO
南非 國家/地區 ZA
南喬治亞及南桑威奇群島 CountryGS
西班牙 國家/地區西班牙文
斯里蘭卡 國家/地區 KK
蘇丹 國家/地區 SD
蘇利南 國家/地區 SR
冷岸及央棉群島 國家/地區
史瓦帝尼 國家/地區 ZZ
瑞典 國家/地區 SE
瑞士 國家/地區 CH
敘利亞阿拉伯共和國 國家/地區 SY
台灣 國家/地區臺灣
塔吉克 國家/地區:TJ
坦尚尼亞聯合共和國 國家/地區 TZ
泰國 國家/地區 TH
多哥 國家/地區納稅人識別號碼
托克勞 國家/地區:KK
東加 國家/地區 TO
千里達及托巴哥 國家/地區 TT
突尼西亞 國家/地區特區
土耳其 國家/地區 TR
土庫曼 國家/地區 TM
土克凱可群島 鄉村
吐瓦魯 鄉村電視節目
烏干達 國家/地區 UG
烏克蘭 國家/地區通用 Analytics (分析)
阿拉伯聯合大公國 國家/地區
英國 英國
美國 國家/地區 (US)
美屬邊疆群島 國家/地區 UM
烏拉圭 國家/地區 UY
烏茲別克 國家/地區 UZ
萬那杜 國家/地區
委內瑞拉 國家/地區 VE
越南 國家/地區
英屬維京群島 國家/地區
美屬維京群島 國家/地區 VI
瓦利斯群島和富圖那群島 國家/地區 WF
西撒哈拉 國家/地區 EH
葉門 國家/地區
南斯拉夫 國家/地區
尚比亞 國家/地區 MM
辛巴威 國家/地區 ZW

國家代碼

下表列出兩個字母的國家/地區代碼,可用做 gl 參數的值:

國家/地區 國家/地區代碼
阿富汗 af
阿爾巴尼亞
阿爾及利亞 dz
美屬薩摩亞 CANNOT TRANSLATE
安道爾 廣告
安哥拉 埃奧
安吉拉 AI
南極洲 Aq
安地卡及巴布達 AG
阿根廷 ar
亞美尼亞 am
阿魯巴島 AW
澳洲 au
奧地利
亞塞拜然 az
巴哈馬 bs
巴林 bh
孟加拉 bd
巴貝多 bb
白俄羅斯 要求者
比利時 be
貝里斯 BZ
貝南 BJ
百慕達 BM
不丹 bt
玻利維亞 bo
波士尼亞與赫塞哥維納 Ba
波札那 黑白
波維特島 BV
巴西 br
英屬印度洋領地 IO
汶萊 bn
保加利亞 bg
布吉納法索 BF
蒲隆地 商業智慧 (BI)
柬埔寨 kh
喀麥隆 公分
加拿大 ca
維德角 轉換率
開曼群島 ky
中非共和國 參考資源
查德 西班牙
智利 cl
中國 cn
聖誕島 cx
科科斯 (基林) 群島 副本收件人
哥倫比亞 co
葛摩 公里
剛果 cg
剛果民主共和國 持續推送軟體更新
庫克群島 小克
哥斯大黎加 cr
象牙海岸 持續整合
克羅埃西亞 小時
古巴 C
賽普勒斯 cy
捷克共和國 cz
丹麥 dk
吉布地 DJ
多米尼克 dm
多明尼加共和國 do
厄瓜多 ec
埃及 eg
薩爾瓦多 sv
赤道幾內亞 GG
厄利垂亞 個地球半徑
愛沙尼亞 ee
衣索比亞 et
福克蘭群島 (馬爾維納斯) Fk
法羅群島 fo
斐濟 fj
芬蘭 fi
法國 fr
法屬圭亞那 GF
法屬玻里尼西亞 十字
法屬南部領地 tf
加彭 ga
甘比亞 GM
喬治亞 ge
德國 de
迦納 gh
直布羅陀 Gi
希臘 gr
格陵蘭 gl
格瑞那達 gd
瓜地洛普 全球衛星定位系統
關島 gu
瓜地馬拉 gt
幾內亞 gn
幾內亞比索 gwS
蓋亞那 CANNOT TRANSLATE
海地 ht
赫德島和麥克唐納群島 小時
教廷 (梵蒂岡)
宏都拉斯 hn
香港 hk
匈牙利 hu
冰島
印度 in
印尼 id
伊朗伊斯蘭共和國 I 鍵
伊拉克 IQ
愛爾蘭 ie
以色列 il
義大利 it
牙買加 JM
日本 jp
約旦 jo
哈薩克 kz
肯亞 ke
吉里巴斯 ki
朝鮮民主主義人民共和國 (北韓) KP
大韓民國 kr
科威特 kw
吉爾吉斯 公斤
寮國 la
拉脫維亞 lv
黎巴嫩 lb
賴索托 ls
賴比瑞亞 歌詞
利比亞 ly
列支敦斯登 li
立陶宛 lt
盧森堡 lu
澳門
馬其頓 (前南斯拉夫) mk
馬達加斯加 mg
馬拉威 MW
馬來西亞 my
馬爾地夫 mv
馬利 ml
馬爾他 mt
馬紹爾群島 mh
馬丁尼克 平方
茅利塔尼亞 mr
模里西斯 靜音
馬約特 YouTube
墨西哥 mx
密克羅尼西亞聯邦 FM
摩爾多瓦共和國 平方公尺
摩納哥 英國
蒙古 mn
蒙哲臘 ms
摩洛哥 ma
莫三比克 MZ
緬甸 mm
納米比亞
諾魯 NN
尼泊爾 np
荷蘭 nl
荷屬安替列斯 一個
新喀里多尼亞 加拿大
紐西蘭 nz
尼加拉瓜 ni
尼日 ne
奈及利亞 ng
紐埃
諾福克島 NF
北馬利安納群島 MP
挪威
阿曼 om
巴基斯坦 pk
帛琉 PW
巴勒斯坦佔領區 ps
巴拿馬 pa
巴布亞紐幾內亞 PG
巴拉圭 py
秘魯 pe
菲律賓 ph
皮特肯 PN
波蘭 pl
葡萄牙 pt
波多黎各 pr
卡達 qa
留尼旺 Re
羅馬尼亞 ro
俄羅斯聯邦 ru
盧安達 RW
聖赫勒拿島 S 鍵
聖克里斯多福及尼維斯 kn
聖露西亞 lc
聖皮埃與密克隆群島 下午
聖文森與格瑞那丁 vc
薩摩亞 ws
聖馬利諾 sm
聖多美普林西比 st
沙烏地阿拉伯 sa
塞內加爾 sn
塞爾維亞蒙特內哥羅 cs
塞席爾 SSC
獅子山 sl
新加坡 sg
斯洛伐克 sk
斯洛維尼亞 si
索羅門群島 sb
索馬利亞 超級輪
南非 za
南喬治亞及南桑威奇群島 gs
西班牙 es
斯里蘭卡 公斤
蘇丹 sd
蘇利南 sr
冷岸及央棉群島 SJ
史瓦帝尼 SZ
瑞典 se
瑞士 ch
敘利亞阿拉伯共和國 sy
台灣 tw
塔吉克 TJ
坦尚尼亞聯合共和國 tz
泰國 th
東帝汶 tl
多哥 tg
托克勞 千兆
東加
千里達及托巴哥 tt
突尼西亞 tn
土耳其 tr
土庫曼
土克凱可群島 tc
吐瓦魯 電視
烏干達 英國
烏克蘭 ua
阿拉伯聯合大公國 ae
英國 uk
美國 us
美屬邊疆群島
烏拉圭 uy
烏茲別克 uz
萬那杜 Vu
委內瑞拉 V 鍵
越南 vn
英屬維京群島 vg
美屬維京群島 vi
瓦利斯群島和富圖那群島 WF
西撒哈拉 Eh
葉門
尚比亞 ZM
辛巴威 ZW