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)

注意：您可能已经注意到 上面的第二个示例使用 AND 运算符，用于指定不应将结果写入 法语或意大利语。根据查询中括号的位置，您可以 可以使用布尔值 AND 运算符或布尔值 OR 运算符来表示 查询。这是因为如果某个文档是用法语写成的，那么它就不是用意大利语编写的。因此，您的布尔语句必须表达出 文档不是用法语撰写的，并且不是 这些文字是用意大利语写的。

布尔值 OR [|]
说明

OR 运算符 (|) 会返回 左侧的集合或该集合右侧的集合 竖线（“|”）运算符。
示例

本示例返回以 简体中文或繁体中文：
lr=lang_zh-TW|lang_zh-CN

本示例请求所有不是以 法语或意大利语；请注意，它会将圆括号放在其他位置 与使用布尔值 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”参数值可能会影响搜索结果，尤其是 国际查询。在此类 用例、“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 网页搜索提供了多种过滤搜索结果的方法 结果：

自动过滤搜索结果

为了尽可能提供最佳搜索结果，Google 使用两种方法自动过滤 通常被视为不良内容：

  • 重复内容：如果多个文档包含 那么只有这组文档中最相关的文档 。

  • 挤出参与者：如果有多个搜索结果 那么 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
挪威语（尼诺斯克语） 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