JSON API 参考文档

布尔值 OR 搜索 [ 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 运算符来指定结果不应用法语或意大利语编写。根据括号在查询中的位置，您可以使用布尔 AND 运算符或布尔 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 会为每个查询选择最优质的搜索结果。

如需查看“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 会使用以下两种技术自动过滤通常被视为不合适的搜索结果：

  • 重复内容 - 如果多个文档包含相同的信息，则搜索结果中只会包含这组文档中最相关的文档。

  • 主机拥挤 - 如果有多个搜索结果来自同一网站，Google 可能不会显示来自该网站的所有结果，或者这些结果在排名
    中的排名可能会低于预期。

我们建议您针对一般搜索请求让这些过滤器保持启用状态，因为这些过滤器可显著提高大多数搜索结果的质量。不过，您可以在搜索请求中将“filter”查询参数设置为 0，从而绕过这些自动过滤器。

使用安全搜索功能过滤成人内容

许多 Google 客户都不想显示包含成人内容的网站的搜索结果。借助安全搜索过滤器，您可以过滤掉包含成人内容的搜索结果，并将其清除。 Google 的过滤器使用专有技术来检查关键字、词组和网址。虽然任何过滤器都无法做到百分之百准确，但安全搜索功能可以从您的搜索结果中滤除绝大部分成人内容。

Google 会持续抓取网页并整合用户建议的更新，力求确保安全搜索功能尽可能及时、全面。

您可以使用“safe”查询参数调整 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
挪威语（尼诺斯克语） 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