你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

图像搜索 API v5 参考

警告

必应搜索 API 将从认知服务迁移到必应搜索服务。 从 2020 年 10 月 30 日开始,必应搜索的任何新实例都需按照此处所述的过程进行预配。 使用认知服务进行预配的必应搜索 API 将在未来三年或在企业协议结束前(以先发生者为准)得到支持。 有关迁移说明,请参阅必应搜索服务

使用图像搜索 API 可以发送搜索查询以必应并返回相关图像的列表。 本部分提供有关用于请求图像和包含它们的 JSON 响应对象的查询参数和标头的技术详细信息。 有关如何发出请求的示例,请参阅 搜索 Web 查找图像

有关请求应包含的标头的信息,请参阅 请求标头

有关请求应包括的查询参数的信息,请参阅 查询参数

有关响应可能包含的 JSON 响应对象的信息,请参阅 响应对象

有关允许使用和显示结果的信息,请参阅必应搜索 API 使用和显示要求

终结点

若要请求图像,请将 GET 请求发送到以下 URL 之一:

终结点 说明
https://api.cognitive.microsoft.com/bing/v5.0/images/search 返回与用户搜索查询相关的图像。 还可以使用此终结点来获取有关图像的见解,例如包含图像的网页。
https://api.cognitive.microsoft.com/bing/v5.0/images/trending 基于其他人的搜索请求返回热门图像。 图像分为不同的类别。 例如,热门人员搜索。

有关支持热门图像的市场列表,请参阅热门图像

请求必须使用 HTTPS 协议。

注意

最大 URL 长度为 2,048 个字符。 为了确保 URL 长度不超出限制,查询参数的最大长度应不到 1,500 个字符。 如果 URL 超出 2,048 个字符,服务器会返回“404 未找到”。

标头

下面是请求和响应可能包含的标头。

标头 说明
Accept 可选请求标头。

默认的媒体类型为“application/json”。 若要指定响应使用 JSON-LD,请将 Accept 标头设置为“application/ld+json”。
Accept-Language 可选请求标头。

以逗号分隔的语言列表,用于用户界面字符串。 此列表以降序方式显示首选项。 有关详细信息,包括预期格式,请参阅 RFC2616

此标头和 setLang 查询参数相互排斥,不可同时指定两者。

如果设置此标头,则还必须指定 cc 查询参数。 若要确定要返回结果的市场,必应使用从列表中查找的第一种受支持的语言,并将其与参数值组合在一起cc。 如果列表不包括支持的语言,必应会查找最接近的语言和支持请求的市场,或将聚合或默认市场用于结果。 若要确定必应使用的市场,请查看 BingAPIs-Market 标头。

仅当指定多个语言时,才可使用此标头和 cc 查询参数。 否则,请使用 mktsetLang 查询参数。

用户界面字符串是用作用户界面中标签的字符串。 JSON 响应对象中有几个用户界面字符串。 响应对象中 Bing.com 属性的任何链接均将应用指定的语言。
BingAPIs-Market 响应标头。

请求使用的市场。 形式为 <languageCode>-<countryCode>。 例如,en-US。

如果指定市场 代码中未列出的市场,此值可能与 mkt 查询参数中指定的市场不同。 如果为无法协调的 ccAccept-Language 指定值,则也是如此。
BingAPIs-TraceId 响应标头。

包含请求详细信息的日志条目 ID。 发生错误时,捕获此 ID。 如果无法确定并解决问题,请纳入此 ID 以及提供给支持团队的其他信息。
Ocp-Apim-Subscription-Key 必需请求标头。

认知服务中注册此服务时收到的订阅密钥。
Retry-After 响应标头。

如果超过每秒 (QPS) 或每月 (QPM) 允许的查询数,则响应将包含此标头。 标头包含在发送另一个请求之前必须等待的秒数。
User-Agent 可选请求标头。

发出请求的用户代理。 必应使用用户代理为移动用户提供优化体验。 尽管是可选的,但还是建议始终指定此标头。

user-agent 应该是任何常用浏览器发送的字符串。 有关用户代理的信息,请参阅 RFC 2616

下面是 user-agent 字符串示例。
  • Windows Phone - Mozilla/5.0(兼容;MSIE 10.0;Windows Phone 8.0;Trident/6.0;IEMobile/10.0;ARM;Touch;NOKIA;Lumia 822)

  • Android - Mozilla/5.0(Linux;U;Android 2.3.5;en-us;SCH-I500 Build/GINGERBREAD)AppleWebKit/533.1(KHTML,如 Gecko)版本/4.0 Mobile Safari/533.1

  • iPhone - Mozilla/5.0(iPhone;CPU iPhone OS 6_1,如 Mac OS X)AppleWebKit/536.26(KHTML;如 Gecko)Mobile/10B142 iPhone4;1 BingWeb/3.03.1428.20120423

  • PC - Mozilla/5.0(Windows NT 6.3;WOW64;Trident/7.0;Touch;rv:11.0),如 Gecko

  • iPad - Mozilla/5.0(iPad;CPU OS 7_0,如 Mac OS X)AppleWebKit/537.51.1(KHTML,如 Gecko)版本/7.0 Mobile/11A465 Safari/9537.53
X-MSEdge-ClientID 可选请求和响应标头。

必应使用此标头跨必应 API 调用为用户提供一致的行为。 必应通常会发布新功能和改进,并将客户端 ID 用作密钥以在不同航班上分配客流量。 如果未跨多个请求将相同的客户端 ID 用于用户,则必应可能将用户分配给多个冲突的航班。 分配给多个冲突航班可能导致用户体验不一致。 例如,如果第二个请求与第一个请求的航班分配不同,体验可能会出现意外。 此外,必应可以使用客户端 ID 为客户端 ID 的搜索历史记录定制 Web 结果,从而为用户提供更丰富的体验。

通过分析由客户端 ID 生成的活动,必应还会使用此标头来提高结果排名。 相关改进有助于提高必应 API 交付的结果质量,从而提高 API 客户的点击率。

重要提示:尽管是可选的,但应将此标头视为必选。 对于同一最终用户和设备组合,如果跨多个请求保留客户端 ID,则 1) API 客户可以获取一致的用户体验;2) 可通过必应 API 提高结果质量,从而提高点击率。

下面是适用于此标头的基本用法规则。
  • 在设备上使用你的应用程序的每个用户必须具有必应生成的唯一客户端 ID。

    如果未在请求中包含此标头,必应会生成 ID,然后在 X-MSEdge-ClientID 响应标头中将其返回。 仅当用户首次在设备上使用应用时,才不可以在请求中包含此标头。

  • 针对应用为设备上的此用户生成的每个必应 API 请求,使用客户端 ID。

  • 注意:必须确保此客户端 ID 不能链接到任何可以进行身份验证的用户帐户信息。

  • 保留客户端 ID。 若要在浏览器应用中保留 ID,请使用持久性 HTTP Cookie 来确保所有会话均使用此 ID。 请勿使用会话 Cookie。 对于移动应用等其他应用,请使用设备的持久存储来保留 ID。

    下次用户在该设备上使用你的应用时,会获取保留的客户端 ID。

注意:必应响应不一定包含此标头。 如果响应包含此标头,请针对该设备上的用户捕获客户端 ID 并将其用于所有后续必应请求。

注意 如果包括 X-MSEdge-ClientID,则不得在请求中包含 Cookie。
X-Search-ClientIP 可选请求标头。

客户端设备的 IPv4 或 IPv6 地址。 IP 地址用于发现用户的位置。 必应使用位置信息来确定安全搜索行为。

注意:尽管是可选的,但还是建议始终指定此标头和 X-Search-Location 标头。

不要混淆地址(例如,通过将最后一个八位字节更改为 0 来混淆地址)。 混淆地址会导致位置未处于设备实际位置附近,这可能导致必应提供错误的结果。
X-Search-Location 可选请求标头。

以分号分隔的键/值对列表,描述客户端的地理位置。 必应使用位置信息来确定安全搜索行为并返回相关的本地内容。 以 <键>:<值> 形式指定键/值对。 下面是用于指定用户位置的键。

  • lat - 必需。 客户位置的纬度,以度为单位。 纬度必须大于或等于 -90.0 且小于或等于 +90.0。 负值表示南纬,正值表示北纬。

  • long - 必需。 客户位置的经度,以度为单位。 经度必须大于或等于 -180.0 且小于或等于 +180.0。 负值表示西经,正值表示东经。

  • re - 必需。 半径(以米为单位),指定坐标的水平准确性。 传递设备定位服务返回的值。 典型的值可能是:22m - GPS/Wi-Fi、380m - 蜂窝基站三角网定位、18,000m - 反向 IP 查询。

  • ts - 可选。 客户位于相应位置时的 UTC UNIX 时间戳。 (UNIX 时间戳是自 1970 年 1 月 1 日起的秒数。)

  • head - 可选。 客户端的相对航向或旅行方向。 以度数指定旅行方向(从 0 到 360),相对于正北方向顺时针计数。 如果 sp 键为非零值,则指定此键。

  • sp - 可选。 客户设备移动的水平速度(速度),以米/秒为单位。

  • alt - 可选。 客户设备的高度,以米为单位。

  • are - 可选。 半径(以米为单位),指定坐标的垂直准确度。 只有在指定 alt 键的情况下才指定此键。

注意:尽管许多键是可选的,但提供的信息越多,位置结果越精确。

注意:尽管是可选的,但还是建议始终指定用户的地理位置。 如果客户端的 IP 地址未准确反映用户的物理位置(例如,如果客户端使用 VPN),则提供位置尤其重要。 为了获得最佳结果,应包含此标头和 X-Search-ClientIP 标头,但至少应包含此标头。

注意

请记住,使用条款要求遵守所有适用的法律,包含这些标头的用法。 例如,在某些管辖区(如欧洲),在用户设备上放置某些跟踪设备之前,需要获得用户同意。

查询参数

以下是请求可能包含的查询参数。 请查看所需参数的“必需”列。 查询参数值必须经过 URL 编码。 有关用于筛选必应返回的图像的查询参数的信息,请参阅“筛选查询参数”。

名称 类型 必需
出租车 要裁剪的区域的底部坐标。

坐标是原始图像高度的分数值,是从图像的左上角测量的。 将坐标指定为从 0.0 到 1.0 的值。

此参数仅受 Insights API 支持;在调用图像、趋势图像或 Web 搜索 API 时不指定此参数。
Float
卡尔 要裁剪的区域的左坐标。

坐标是原始图像宽度的一小部分,从图像的左上角测量。 将坐标指定为从 0.0 到 1.0 的值。

此参数仅受 Insights API 支持;在调用图像、趋势图像或 Web 搜索 API 时不指定此参数。
Float
要裁剪的区域的正确坐标。

坐标是原始图像宽度的一小部分,从图像的左上角测量。 将坐标指定为从 0.0 到 1.0 的值。

此参数仅受 Insights API 支持;在调用图像、趋势图像或 Web 搜索 API 时不指定此参数。
Float
要裁剪的区域的顶部坐标。

坐标是原始图像的高度的一小部分,是从图像的左上角测量的。 将坐标指定为从 0.0 到 1.0 的值。

此参数仅受 Insights API 支持;在调用图像、趋势图像或 Web 搜索 API 时不指定此参数。
Float
Ct 用于根据 cal、cat、car 和 cab 参数中指定的坐标裁剪图像的裁剪类型。

下面是可能的值。
  • 0 — 矩形 (默认)

此参数仅受 Insights API 支持;在调用图像、趋势图像或 Web 搜索 API 时不指定此参数。
无符号整数
cc 结果来源的国家/地区的 2 个字符国家/地区代码。 有关可能值的列表,请参阅 市场代码

如果设置此参数,则还必须指定 Accept-language 标头。 必应使用指定语言中查找的第一种受支持语言,并将其与国家/地区代码相结合,以确定市场以返回结果。 如果语言列表不包括支持的语言,必应会查找最接近的语言和支持请求的市场。 或者,必应可能会对结果使用聚合市场或默认市场。

仅当指定多种语言时,才使用此查询参数和 Accept-Language 标头。 否则,应使用 mktsetLang 查询参数。

此参数和 mkt 查询参数相互排斥,不可同时指定两者。
String
count 响应中要返回的图像数。 提供的实际结果数可能小于请求获取的结果数。 默认值为 35。 最大值为 150。

可以将此参数与参数一起使用 offset 来页结果。 例如,如果用户界面每页显示 20 张图像,则设置为 count 20 和 offset 0 以获取结果的第一页。 对于每个后续页面,将递增 offset 20 (,例如 0、20、40) 。

此参数仅受图像搜索 API 支持;调用Insights、趋势图像或 Web 搜索 API 时,请勿指定此参数。
UnsignedShort
id 唯一标识图像的 ID。 可以使用此参数来确保指定的图像是图像列表中的第一个图像。 Image 对象的imageId字段包含将此参数设置为的 ID。 String
imgUrl 要获取见解的图像的 URL。 使用此参数作为使用参数指定图像的 insightsToken 替代方法。

若要指定图像,可以使用此参数,也可以将图像的二进制文件放置在 POST 请求的正文中, (看到 Content-Type 标头。

受支持的最大图像大小为 1 MB。

此参数仅受 Insights API 支持;在调用图像、趋势图像或 Web 搜索 API 时不指定此参数。
String
insightsToken 上一个图像搜索 API 调用中的令牌 (请参阅 imageInsightsToken) 。 指定此参数以获取有关图像的其他信息,例如标题或购物源。 有关可获取的其他信息的列表,请参阅 modulesRequested 查询参数。

此参数仅受 Insights API 支持;在调用图像、趋势图像或 Web 搜索 API 时不指定此参数。
String
mkt 产生结果的市场。 通常, mkt 是用户发出请求的国家/地区。 但是,如果用户不在必应提供结果的国家/地区,则可能是不同的国家/地区。 市场必须采用语言代码国家/地区代码><>的形式。< 例如,en-US。 字符串不区分大小写。 有关可能的市场值的列表,请参阅 市场代码

注意: 如果已知,建议始终指定市场。 指定市场有助于必应路由请求,并返回适当的最佳响应。 如果指定市场代码中未列出的市场,则必应根据要更改的内部映射使用最适合的市场代码。

此参数和 cc 查询参数相互排斥,不可同时指定两者。
String
modulesRequested 要请求的一个或多个见解的逗号分隔列表。 (URL 编码查询字符串时,逗号更改为 %2C.) 以下可能不区分大小写的值。
  • All - 返回除 RecognizedEntities 之外的所有见解(如果有)。

  • 批注 - 提供图像中找到的内容类型的特征。 例如,如果图像是某个人的,批注可能会指示该人的性别和他们正在穿的衣服类型。

  • BRQ — 描述图像的最佳代表性查询。

  • 标题 - 提供有关图像信息的标题。 如果标题包含实体,响应可能包含指向这些实体图像的链接。

  • 集合 - 相关图像的列表。

  • 食谱 - 用于烹饪图像中显示的食物的食谱列表。
  • PagesIncluding - 包含图像的网页列表。

  • RecognizedEntities - 图像中识别的实体列表 (人员) 。

    注意: 不能使用任何其他模块指定此模块。 如果使用其他模块指定它,则响应不包括此模块。

  • RelatedSearches - 由其他人进行的相关搜索列表。

  • ShoppingSources - 可在其中购买相关产品/服务的商家列表。

  • SimilarImages - 视觉上类似于原始图像的图像列表。

  • SimilarProducts - 包含与原始图像中找到的产品类似的产品的图像列表。

如果指定模块且模块没有数据,则响应对象不包括相关字段。 例如,如果指定 Caption 且不存在,则响应不包含该 imageCaption 字段。

若要包含相关搜索,请求必须包含原始查询字符串。

尽管类似图像或产品不需要原始查询字符串,但应始终包含它,因为它可以帮助提高相关性和结果。

此参数仅受图像搜索 API 支持;调用趋势图像 API 或搜索 API 时,请勿指定此参数。
String
offset 从零开始的偏移量,指示在返回图像之前要跳过的图像数。 默认值为 0。 偏移量应小于 (totalEstimatedMatches - count) 。

将此参数与参数一起使用 count 以对结果进行分页。 例如,如果用户界面每页显示 20 张图像,则设置为 count 20 和 offset 0 以获取结果的第一页。 对于每个后续页面,将递增 offset 20 (,例如 0、20、40) 。

多个页面可以在结果中包含一些重叠。 若要防止重复,请参阅 nextOffsetAddCount

此参数仅受图像搜索 API 支持;调用趋势图像 API 或搜索 API 时,请勿指定此参数。
未签名的短
q 用户的搜索查询字符串。 查询字符串不能为空。

查询字符串可能包含高级运算符必应。 例如,若要将图像限制为特定域,请使用 站点: 运算符。

为了帮助提高见解查询的相关性, (查看 insightsToken) ,应始终包含用户的查询字符串。

此参数仅受图像搜索 API 支持;调用趋势图像 API 时,请勿指定此参数。
String
safeSearch 筛选成人内容的图像。 下面是可能的筛选器值。
  • 关闭 - 可能会返回包含成人内容的图像。 如果请求通过图像搜索 API,则响应包含 (非模糊) 的缩略图。 如果请求通过 Web 搜索 API,响应将包含像素化 (模糊) 的缩略图。

  • 中等 - 如果请求是通过图像搜索 API,则响应不包括包含成人内容的图像。 如果请求通过 Web 搜索 API,响应可能包含成人内容的图像, (缩略图图像 (模糊) ) 像素化。

  • 严格 - 不要返回包含成人内容的图像。

如果未指定,则默认值为“中等”。

注意:如果请求来自需要将必应成人策略safeSearch的市场设置为“严格”,必应将忽略safeSearch该值并使用 Strict。

注意:如果使用 site: 查询运算符,则不管 safeSearch 查询参数设置如何,仍有可能出现响应中包含成人内容的情况。 只有在知道网站内容且方案允许使用成人内容的情况下,才应使用 site:
字符串
setLang 可用于用户界面字符串的语言。 使用 ISO 639-1 2 字母语言代码指定语言。 例如,英语的语言代码是 EN。 默认为 EN(英语)。

尽管是可选项,但应始终指定语言。 通常情况下,请将 setLang 设置为 mkt 所指定的语言,除非用户希望以另一语言显示用户界面字符串。

此参数和 Accept-Language 标头相互排斥,不可同时指定两者。

用户界面字符串是用作用户界面中标签的字符串。 JSON 响应对象中有几个用户界面字符串。 此外,响应对象中 Bing.com 属性的任何链接均会应用指定的语言。
字符串

筛选查询参数

下面是可用于筛选必应返回的图像的可选筛选器查询参数。 查询参数值必须经过 URL 编码。

只有图像搜索 API 支持这些查询参数;调用趋势图像 API 或 Web 搜索 API 时,请勿指定这些参数。

名称 类型
方面 按纵横比筛选图像。 下面是可能的筛选器值。
  • 方形 - 返回具有标准纵横比的图像
  • 宽 - 返回具有宽屏幕纵横比的图像
  • 高 - 返回高纵横比的图像
  • 全部 - 不要按方面进行筛选。 指定此值与不指定 aspect 参数相同。
String
颜色 按颜色筛选图像。 下面是可能的筛选器值。
  • ColorOnly - 返回颜色图像
  • 单色 - 返回黑白图像

返回具有以下主要颜色之一的图像:
  • 黑色
  • 蓝色
  • Brown
  • 灰色
  • 绿色
  • 橙色
  • 粉色
  • 紫色
  • Red
  • 青色
  • White
  • Yellow
String
新鲜 按必应发现图像时筛选图像。 下面是可能的筛选器值。
  • Day - 返回过去 24 小时内发现的图像
  • 周 - 返回在过去 7 天内发现的图像
  • 月 - 返回过去 30 天内发现的图像
  • 年份 - 返回去年内发现的图像
String
高度 筛选具有指定高度的图像(以像素为单位)。

可以将此筛选器与筛选器一起使用 size 。 例如,返回高度为 150 像素的小图像。
UnsignedShort
imageContent 按内容筛选图像。 下面是可能的筛选器值。
  • 人脸 - 返回仅显示人员脸的图像
  • 纵向 - 返回仅显示人员头部和肩部的图像
String
imageType 按图像类型筛选图像。 下面是可能的筛选器值。

  • AnimatedGif - 仅返回动画 GIF

  • 剪贴画 - 仅返回剪贴画图像

  • 线条 - 仅返回线条绘图

  • 照片 - 仅返回 (不包括线条图、动画 Gif 和剪贴画)

  • 购物 - 仅返回包含必应知道正在销售商品的商家的图像。 此选项仅在 en-US 市场中有效。

  • 透明 - 仅返回具有透明背景的图像。
String
许可证 按其关联的许可证类型筛选结果。 下面是可能的筛选器值。
  • 任何 - 返回属于任何许可证类型的图像。 响应仅包含显式指定许可证的图像。

  • 公共 - 返回创建者在法律允许的最充分范围内放弃其独家权利的图像。

  • 共享 - 返回可能与其他人共享的图像。 可能不允许更改或编辑图像。 此外,不允许出于商业目的修改、共享和使用映像。 通常,此选项返回的图像最多。

  • ShareCommercially - 返回可能出于个人或商业目的与他人共享的图像。 可能不允许更改或编辑图像。

  • 修改 - 返回可以修改、共享和使用的图像。 可能不允许更改或编辑图像。 不得出于商业目的修改、共享和使用映像。

  • ModifyCommercially - 返回可用于个人或商业目的的修改、共享和使用的映像。 通常,此选项返回最少的图像。

  • 全部 - 不要按许可证类型进行筛选。 指定此值与不指定 license 参数相同。

注意:必应未验证或表示特定许可证是否与映像关联,或者用户可以在该许可证下使用该映像。 有关这些许可证类型的详细信息,请参阅 按许可证类型筛选映像
String
大小 按大小筛选图像。 下面是可能的筛选器值。
  • 小 - 返回小于 200x200 像素的图像

  • 中 - 返回大于或等于 200x200 像素但小于 500x500 像素的图像

  • 大 - 返回 500x500 像素或更大的图像

  • 壁纸 - 返回壁纸图像。

  • 全部 - 不要按大小进行筛选。 指定此值与不指定 size 参数相同。

可以将此参数与或width参数一起使用height。 例如,可以使用 heightsize 请求高 150 像素的小图像。
String
宽度 筛选具有指定宽度的图像(以像素为单位)。

可以将此筛选器与筛选器一 size 起使用。 例如,返回宽度为 150 像素的小图像。
UnsignedShort

响应对象

注意

为了遵守法国新的欧盟版权指令,必应 Web、新闻、视频、图像和所有自定义搜索 API 必须省略来自法国用户某些欧盟新闻源的某些内容。 已删除的内容可能包括缩略图图像和视频、视频预览和附带这些源搜索结果的代码片段。 因此,必应 API 可能会为法国用户提供缩略图和视频、视频预览和代码片段来减少结果。

下面是响应可能包含的 JSON 对象。 如果请求成功,则响应中的顶级对象是 图像 对象(如果终结点为 /images/search,如果请求用于图像见解,则 为 ImageInsightsResponse ;如果终结点为 /images/trending,则为 TrendingImages )。 如果请求失败,则顶级对象为 ErrorResponse 对象。

对象 说明
AggregateOffer 定义具有与图像相关的产品/服务的商家的产品/服务列表。
AggregateRating 定义指示其他项对项的评分方式的指标。
类别 (ImageInsights) 定义图像中找到的特征。
类别 (TrendingImages) 定义趋势图像的类别。
CategoryClassification 定义图像中找到的特征的类别。
错误 定义发生的错误。
ErrorResponse 请求失败时响应包含的顶级对象。
图像 一个对象,其中包含与查询相关的图像的相关信息。
ImageCaption 定义有关图像的标题。
ImageGallery 定义包含相关图像集合的网页的链接。
ImageInsightsResponse 响应包含的顶级对象,当图像见解请求成功时。
映像 响应在图像请求成功时包括的顶级对象。
InsightsSourcesSummary 定义可在其中购物或执行与图像相关的其他操作的网站数的计数。
MediaSize 定义媒体内容的大小。
NormalizedRectangle 定义图像的区域。
检测 定义必应检测 URL。
产品/服务 定义商家的产品/服务。
组织 定义有关商家的信息。
Person 定义人员。
透视 定义透视段。
ProductSummaryImage 定义产品的映像,并提供有关产品必应联机找到的产品/服务的摘要信息。
查询 定义搜索查询字符串。
配方 定义烹饪食谱。
RecognizedEntity 定义识别的实体。
RecognizedEntityGroup 定义一组以前识别的实体。
RecognizedEntityRegion 定义一个区域,其中找到了一个实体,以及可能与它匹配的实体列表。
缩略 图 定义缩略图。
磁贴 定义图像磁贴。
TrendingImages 响应包含的顶级对象,当热门图像请求成功时。

AggregateOffer

定义与图像相关的商家的产品/服务列表。

元素 说明 类型
提供 具有与图像相关的产品/服务的商家的产品/服务列表。 Offer[]

AggregateRating

定义指标,这些指标指示其他项的分级程度。

名称 类型
bestRating 评价最高的评论。 可能的值为 1.0 到 5.0。 FLOAT
ratingValue 平均 (平均) 评级。 可能的值为 1.0 到 5.0。 FLOAT
reviewCount 食谱被分级或审查的次数。 无符号整数
text 平均 (平均) 分级,以字符串形式表示。 String

Category (TrendingImages)

定义趋势图像的类别。

TrendingImages 命名空间定义此对象。

元素 说明 类型
磁贴 类别中趋势的图像列表。 每个磁贴都包含一个图像和一个必应查询,该查询返回主题的更多图像。 例如,如果类别为“热门人搜索”,则图像是一个热门人,查询将是该人员的更多图像。 Tile[]
title 图像类别的名称。 例如,热门人员搜索。 String

类别 (ImageInsights)

定义图像中找到的特征。

ImageInsights 命名空间定义此对象。

元素 说明 类型
confidence 必应正确标识类别的信心。 可能的值为 0.0 到 1.0,其中 1.0 表示必应 100% 确信类别正确。 Float
name 类别的名称。 String

CategoryClassification

定义图像中找到的特征的类别。

元素 说明 类型
Categories 图像中找到的特征列表。 例如,如果图像是音乐艺术家,数组可能包括女性、连衣裙和音乐,以指示该人是女性,穿着礼服,并且是音乐艺术家。 Category[]

错误

定义发生的错误。

元素 说明 类型
code 用于标识错误的错误代码。 如需可能的代码的列表,请参阅错误代码 字符串
message 对错误的说明。 字符串
parameter 请求中导致错误的查询参数。 字符串
value 查询参数的无效值。 字符串

ErrorResponse

请求失败时响应包含的顶级对象。

名称 类型
_type 类型提示。 字符串
errors 错误的列表,用于说明请求失败原因。 Error[]

映像

定义与查询相关的图像。

注意

由于 URL 格式和参数可能未经通知更改,因此应按原样使用所有 URL;不应依赖于 URL 格式或参数。 例外是重 设大小和裁剪缩略图图像所讨论的参数和值。

名称 类型
accentColor 一个三字节十六进制数,表示主宰图像的颜色。 客户端可将颜色用作临时背景,直到加载图像。 String
contentSize 图像的文件大小。 字符串的格式为 {size} {units},其中 {units} 可以设置为 B 表示字节、Kb for Kilobyte 等。例如,12345 B 表示图像的大小为 12,345 字节。 String
contentUrl 源网站上的图像的 URL。 String
datePublished 必应发现图像的日期和时间(以 UTC 为单位)。 日期的格式为 YYYY-MM-DDTHH:MM:SS。 String
encodingFormat 图像的 mime 类型 (例如 jpeg) 。 String
高度 源图像的高度(以像素为单位)。 未签名的短
hostPageDisplayUrl 承载图像的网页的显示 URL。

你将在用户界面中使用此 URL 来标识包含图像的主机网页。 此 URL 格式不正确,因此不要使用它访问主机网页。 URL 不包括协议 (,例如 HTTP) ,并且可能包含命中突出显示字符。 若要访问主机网页,请使用 hostPageUrl URL。
String
hostPageUrl 包含图像的网页的 URL。

此 URL 可能 contentUrl 相同。
String
id 唯一标识映像列表中的此映像的 ID。

仅当图像包含在搜索 API 搜索结果中并且排名响应指定图像的特定位置时,图像对象才包含此字段。 有关如何使用此字段的信息,请参阅 使用排名在 Web 搜索 API 指南中显示结果。
String
imageId 唯一标识映像列表中的此映像的 ID。 如果希望映像是响应中的第一个映像,请将 ID 查询参数设置为请求中的此 ID。 String
imageInsightsToken 在后续调用图像搜索 API 时使用的令牌,用于获取有关图像的其他信息。 有关使用此令牌的信息,请参阅 insightsToken 查询参数。 String
insightsSourcesSummary 可以购物或执行与图像相关的其他操作的网站数的计数。

例如,如果图像是苹果饼,则此对象包含可以购买苹果饼的网站数的计数。 然后,可以包括错误 (,例如购物车图标) 和用于指示产品/服务的计数。 当用户单击图标时,可以使用 imageInisghtsToken 该图标获取网站列表。

有关何时显示错误的信息,请参阅 displayRecipeSourcesBadges 和 displayShoppingSourcesBadges。
InsightsSourcesSummary
名字 图像的标题。 String
缩略 图 缩略图的宽度和高度 () 。thumbnailUrl MediaSize
thumbnailUrl 图像缩略图的 URL。 有关调整图像大小的信息,请参阅 重设图像大小和裁剪缩略图图像 字符串
webSearchUrl 此图像必应搜索结果的 URL。 String
宽度 源图像的宽度(以像素为单位)。 未签名的短

ImageCaption

定义图像的标题。

名称 类型
标题 有关图像的标题。 String
dataSourceUrl 找到标题的网站的 URL。 必须将标题属性属性到源。 例如,显示标题旁边的 URL 中的域名,并使用 URL 链接到源网站。 String
relatedSearches 标题中找到的实体列表。 若要将用户带到实体的图像,请使用对象中的 Query 链接。 查询

ImageGallery

定义包含相关图像集合的网页的链接。

名称 类型
创造者 拥有集合的人员。 必须将集合归因于创建者。 Person
描述 集合的说明。 说明可能为空。 String
followersCount 关注创建者的社交网络上的用户数。 无符号整数
imagesCount 集合中找到的相关图像数。 无符号整数
在其中找到图像的发布者或社交网络。 必须将发布者归为找到集合的源。 String
thumbnailUrl 集合中找到的图像之一的缩略图的 URL。 String
Url 包含相关图像集合的网页的 URL。 String

ImageInsightsResponse

响应包含的顶级对象,当图像见解请求成功时。

有关请求图像见解的信息,请参阅 insightsToken 查询参数。

modulesRequested 查询参数会影响响应中必应包含的字段。 如果仅设置为 modulesRequested Caption,则此对象仅 imageCaption 包含字段。

名称 类型
_type 类型提示。 字符串
bestRepresentativeQuery 最能表示图像的查询字符串。 单击对象中的 Query 链接,将用户带到具有更多图像图片的网页。 查询
categoryClassification 一个类别列表,用于标识图像中发现的内容的特征。 例如,如果图像是某个人的,批注可能会指示该人的性别和他们正在穿的衣服类型。 CategoryClassification
imageCaption 用于图像的标题。 ImageCaption
imageInsightsToken 在后续调用图像搜索 API 时使用的令牌,用于获取有关图像的其他信息。 有关使用此令牌的信息,请参阅 insightsToken 查询参数。

此令牌与 Image 对象中包含的令牌具有相同的用法。 通常,可以在识别实体方案中使用此令牌,在该方案中使用 imgUrl 查询参数发送必应图像,并将 modulesRequested 参数设置为 RecognizeedEntities。 响应包括可识别的实体和可用于获取有关图像的其他见解的见解令牌。

如果将 modulesRequested 设置为“全部”,除了识别的实体之外,还可以获取所有可用见解, (无需在后续调用) 中使用见解令牌。
String
pagesIncluding 包含图像的网页列表。 若要访问网页,请使用图像字段中的 hostPageUrl URL。 Image[]
recipes 与图像相关的食谱列表。 例如,如果图像是苹果饼,则列表将包含用于制作苹果饼的食谱。 食谱[]
recognizedEntityGroups 包含与指定映像中找到的实体匹配的实体图像的组列表。 例如,如果实体在该组中被识别,则响应可能包含来自常规名人组的图像。 recognizedEntityGroup[]
relatedCollections 包含相关图像的网页的链接列表。 ImageGallery[]
relatedSearches 其他查询所做相关查询的列表。 Query[]
shoppingSources 提供与图像相关的项的商家列表。 例如,如果图像是苹果饼,列表将包含销售苹果馅饼的商家。 AggregateOffer[]
visuallySimilarImages 视觉上类似于原始图像的图像列表。 例如,如果指定的图像是水体上的日落,则其他日落在水体上的相似图像列表。

如果指定的图像是某个人,则类似的图像可能与同一个人,或者可能与身着相似或类似设置的人相称。

请注意,相似性的标准继续发展。
Image[]
visuallySimilarProducts 包含与原始图像中找到的产品相似的产品的图像列表。 例如,如果指定的图像包含礼服,则类似的图像列表将包含一个礼服。 ProductSummaryImage[]

映像

响应在图像请求成功时包括的顶级对象。

名称 类型
_type 类型提示。 字符串
displayRecipeSourcesBadges 一个布尔值,用于确定是否应包含错误,以指示有可用的食谱。 必应将此标志设置为 true,因为它相信用户的意图是查找食谱。 如果必应不相信用户的意图是查找食谱,则此标志设置为 false

尽管 insightsSourcesSummary 字段的值大于零,但recipeSourcesCount可能displayRecipeSourcesBadgesfalse

此标志仅指示用户的意图。 通常,如果图像 recipeSourcesCount 大于零且 displayRecipeSourcesBadgestrue,则将显示食谱锁屏提醒并计数图像。 否则,如果displayRecipeSourcesBadges为 false,则不会。 对于应用程序,必须决定如何使用这些字段来确定是否显示锁屏提醒。
布尔
displayShoppingSourcesBadges 一个布尔值,用于确定是否应包括错误 (,例如,购物车图标) 指示有可用的购物源。 必应当用户认为用户的意图是购物时,将此标志设置为 true。 如果必应不相信用户的意图是购物,则此标志设置为 false

尽管 insightsSourcesSummary 字段的值大于零,shoppingSourcesCount但可能为 displayShoppingSourcesBadgesfalse

此标志仅指示用户的意图。 通常,如果图像shoppingSourcesCount大于零且displayShoppingSourcesBadges为 true,则将显示购物徽章并计入图像。 否则,如果displayShoppingSourcesBadges为 false,则不会。 对于应用程序,必须决定如何使用这些字段来确定是否显示锁屏提醒。
布尔
id 唯一标识图像答案的 ID。

仅当图像作为 Web 搜索 API 搜索结果的一部分包含时,该对象才包含此字段。 有关如何使用此字段的信息,请参阅 Web 搜索 API 指南中的 “使用排名显示结果 ”。
String
isFamilyFriendly 一个布尔值,该值确定一个或多个图像是否包含成人内容。 如果图像中没有包含成人内容, isFamilyFriendly 则设置为 true。 否则,如果一个或多个图像包含成人内容, isFamilyFriendly 则设置为 false

如果 为 false,则缩略图图像 (模糊) 像素化。

注意: 此字段仅包含在 Web 搜索 API 响应中,而不包含在图像搜索 API 响应中。
布尔
nextOffsetAddCount 要添加到 偏移 量查询参数的数字,以确保在分页结果时不会收到重复项。

如果在第一个请求中设置为 offset 0 和 count 30,然后在第二个请求中设置为 offset 30,则第二个响应中的一些结果可能是第一个响应的重复项。

若要防止重复项,请将值nextOffsetAddCount添加到和的offsetcount 。 例如,如果当前值为 offsetcount 30 且值为 nextOffsetAddCount 9,则设置为 offset 69 (count + offset + nextOffsetAddCount) 。
Integer
pivotSuggestions 原始查询中的段列表。 例如,如果查询是红花,必应可能会将查询细分为 Red 和 Flowers。

花形透视可以包含查询建议,如红牡丹和红菊,红色透视可以包含查询建议,如绿花和黄花。
透视
queryExpansions 缩小原始查询的扩展查询的列表。 例如,如果查询是 Microsoft Surface,则扩展的查询可以是 Microsoft Surface Pro 3、Microsoft Surface RT、Microsoft Surface Phone 和 Microsoft Surface Hub 查询
readLink 返回此答案的 URL。 若要使用 URL,必须根据需要追加查询参数,并包含 Ocp-Apim-Subscription-Key 标头。

图像搜索 API 和搜索 API 响应均包括此字段。 通常,当 URL 包含在搜索响应中并且想要直接查询图像搜索 API 时,将使用该 URL。
String
totalEstimatedMatches 与查询相关的估计图像数。 将此数字与 计数偏移 查询参数一起使用,以对结果进行分页。

仅当调用图像搜索 API 时,对象才包含此字段。 调用 Web 搜索 API 时,该对象不包含此字段。
Long
value 与查询相关的图像列表。

如果没有结果,则数组为空。
Image[]
webSearchUrl 所请求图像的必应搜索结果的 URL。 String

InsightsSourcesSummary

定义可在其中购物或执行与图像相关的其他操作的网站数的计数。

元素 说明 类型
recipeSourcesCount 提供与图像主题相关的食谱的网站数。 无符号整数
shoppingSourcesCount 提供与图像主题相关的商品或服务的网站数。 无符号整数

MediaSize

定义媒体内容的大小。

名称 类型
高度 媒体内容的高度(以像素为单位)。 Integer
width 媒体内容的宽度(以像素为单位)。 Integer

NormalizedRectangle

定义图像的区域。 该区域由该区域的右上角、左下角和右下角的坐标定义。 坐标是原始图像宽度和高度的分数值,范围为 0.0 到 1.0。

名称 类型
bottom 底部坐标。 Float
左侧 左侧坐标。 Float
正确的坐标 Float
top 顶部坐标 Float

产品/服务

定义商家的产品/服务。

此对象由 ShoppingSources 见解和 SimilarProducts 见解使用。 有关字段适用的见解,请参阅说明。

元素 说明 类型
aggregateRating 一个聚合分级,指示产品已由其他人评分程度。

SimilarProducts 使用。
AggregateRating
availability 提供的项目的可用性。 下面是可能的值。
  • 已中断
  • InStock
  • InStoreOnly
  • LimitedAvailability
  • OnlineOnly
  • OutOfStock
  • PreOrder
  • SoldOut

由 ShoppingSources 使用。
String
lowPrice 必应在线找到的产品的最低价格。

SimilarProducts 使用。
Float
name 要提供的产品的名称。 String
offerCount 必应联机找到的产品/服务数。

SimilarProducts 使用。
无符号整数
price 产品要提供的价格。

由 ShoppingSources 使用。
Float
priceCurrency 货币。 例如,USD。 String
卖方 商家的姓名。

由 ShoppingSources 使用。
组织
url 将用户带到商家网站上的产品/服务的 URL。

由 ShoppingSources 使用。
字符串

组织

定义有关商家的信息。

元素 说明 类型
image 商家的徽标。 该 Image 对象仅 url 包含字段。 图像
name 商家的姓名。 字符串

人员

定义人员。

名称 类型
_type 类型提示。 字符串
description 人员的简短说明 String
image 人员的图像。 图像
jobTitle 人员的职务 String
name 人员的姓名。 字符串
url 人员社交网络主页的 URL(如果适用)。 字符串
webSearchUrl 将用户带到包含此人姓名的查询的必应搜索结果页的 URL。 String

透视

定义透视段。

名称 类型
支点 要透视的原始查询中的段。 String
建议 针对透视的建议查询的列表。 查询

ProductSummaryImage

定义产品的映像,并提供有关产品必应联机找到的产品/服务的摘要信息。

注意

由于 URL 格式和参数可能会更改而不通知,因此所有 URL 都应按原样使用;不应依赖 URL 格式或参数。 例外是 重设大小和裁剪缩略图图像讨论的参数和值。

名称 类型
accentColor 一个三字节十六进制数字,表示主宰图像的颜色。 客户端可以使用颜色作为临时背景,直到加载图像。 String
aggregateOffer 必应在图像中为产品联机找到的产品/服务的摘要。 例如,如果图像是连衣裙,则产品/服务标识了连衣裙的最低价格和找到的产品/服务数量。 产品/服务
contentSize 图像的文件大小。 字符串的格式为 {size} {units},其中 {units} 可以设置为 B 表示字节、KB for Kilobyte 等。 例如,12345 B 指示图像的大小为 12,345 字节。 String
contentUrl 源网站上的图像的 URL。 String
datePublished 必应发现图像的日期和时间。 日期采用 YYYY-MM-DDTHH:MM:SS 格式。 String
encodingFormat 图像的 mime 类型 (例如 jpeg) 。 String
高度 源图像的高度(以像素为单位)。 未签名的短
hostPageDisplayUrl 承载图像的网页的显示 URL。

可以在用户界面中使用此 URL 来标识包含图像的主机网页。 此 URL 格式不正确,因此不要使用它来访问主机网页。 URL 不包括协议 (,例如 HTTP) ,可能包括命中突出显示字符。 若要访问主机网页,请使用属性中找到的 hostPageUrl URL。
String
hostPageUrl 包含图像的网页的 URL。

此 URL 可能 contentUrl 相同。
String
id 唯一标识映像列表中的此映像的 ID。

仅当图像包含在 Web 搜索 API 搜索结果中并且排名响应指定图像的特定位置时,图像对象才包含此字段。 有关如何使用此字段的信息,请参阅 Web 搜索 API 指南中的 “使用排名显示结果 ”。
String
imageId 唯一标识映像列表中的此映像的 ID。 可以在后续请求中使用 ID 来确保此图像是图像列表中第一个返回的图像。 若要确保此映像是列表中的第一个映像,请包含 id 查询参数并将其设置为映像 ID。 String
imageInsightsToken 在对图像搜索 API 的后续调用中使用的令牌,用于获取有关图像的其他信息。 有关使用此令牌的信息,请参阅 insightsToken 查询参数。 String
insightsSourcesSummary 可在其中购物或执行与图像相关的其他操作的网站数的计数。

例如,如果图像是苹果饼,则此对象包含可以购买苹果饼的网站数的计数。 然后,可以包括错误 (,例如,购物车图标) 和指示产品/服务数的计数。 当用户单击图标时,可以使用 imageInisghtsToken 该图标来获取网站列表。

有关何时显示错误的信息,请参阅 displayRecipeSourcesBadges 和 displayShoppingSourcesBadges。
InsightsSourcesSummary
name 图像的标题。 String
thumbnail 缩略图图像的宽度和高度 () 。thumbnailUrl MediaSize
thumbnailUrl 图像缩略图的 URL。 有关调整图像大小的信息,请参阅 调整图像大小并裁剪缩略图图像 字符串
webSearchUrl 此图像的必应搜索结果的 URL。 String
width 源图像的宽度(以像素为单位)。 未签名的短

查询

定义搜索查询字符串。

名称 类型
displayText 查询字符串的显示版本。

有关展开的查询 (请参阅 queryExpansions) 和数据透视建议, (查看 pivotSuggestions) ,此字段标识扩展原始查询的术语。 例如,如果查询是 Microsoft Surface,而展开的查询是 Microsoft Surface RT, displayText 则包含 RT。
String
searchLink 用于获取相关搜索结果的 URL。 使用 URL 之前,必须根据需要追加查询参数,并包括 Ocp-Apim-Subscription-Key 标头。

如果要在自己的用户界面中显示结果,请使用此 URL;否则,请使用 webSearchUrl URL。
字符串
text 查询字符串。 String
thumbnail 相关图像缩略图的 URL。

该对象仅包含透视建议和相关搜索的此字段。
缩略 图
webSearchUrl 将用户带到查询的必应搜索结果页的 URL。

如果不在自己的用户界面中显示结果,请使用此 URL;否则,请使用 searchUrl URL。

仅包含相关搜索。
String

配方

定义烹饪食谱。

元素 说明 类型
aggregateRating 聚合分级,表明食谱被其他人评分得有多好。 AggregateRating
cookTime 食物需要煮熟的时间。 例如,PT25M。 有关时间格式的信息,请参阅 Wikipedia.com 的持续时间 String
创造者 食谱的作者。 Person
name 食谱的名称。 String
prepTime 准备成分所需的时间。 例如,PT15M。 有关时间格式的信息,请参阅 Wikipedia.com 的持续时间 String
thumbnailUrl 已准备食品缩略图的 URL。 String
totalTime 准备和烹饪食谱所需的总时间。 例如,PT45M。 有关时间格式的信息,请参阅 Wikipedia.com 的持续时间 字符串
url 将用户带到包含食谱的网页的 URL。 String

RecognizedEntity

定义已识别的实体。

元素 说明 类型
实体 已识别的实体。

下面是可能的实体对象。
对象
matchConfidence 必应图像中的实体与此实体匹配的置信度。 置信度从 0.0 到 1.0 不等,0.0 不自信,1.0 自信。 Float

RecognizedEntityGroup

定义一组以前识别的实体。

元素 说明 类型
name 还会找到实体图像的组的名称。

以下是可能的组。
  • CelebRecognitionAnnotations - 类似于 CelebrityAnnotations,但提供了更准确的匹配概率。

  • 名人注释 - 包含演员、政治家、运动员和历史人物等名人。
String
recognizedEntityRegions 包含实体的图像的区域。 RecognizedEntityRegion[]

RecognizedEntityRegion

定义图像的一个区域,其中找到了实体,以及可能与之匹配的实体列表。

元素 说明 类型
matchingEntities 必应认为与区域中找到的实体匹配的实体列表。 实体按置信度降序 (查看 matchConfidence RecognizedEntity) 字段。 RecognizedEntity[]
region 包含实体的图像的区域。

矩形的值是相对于原始图像的宽和高的,其范围为 0.0 到 1.0。

例如,如果图像为 300x200,并且区域的左上角位于 (10、20) 和底部,右角 (位于 290,150) ,则规范化矩形为:

Left = 0.03333333333333333

Top = 0.1

Right = 0.9666666666666667

Bottom = 0.75

就人来说,该区域代表人的面孔。
NormalizedRectangle

缩略图

定义图像的缩略图。

元素 说明 类型
url 图像缩略图的 URL。 String

Tile

定义图像磁贴。

元素 说明 类型
image 图像缩略图的 URL。 图像
query 返回具有更多主题图像的必应搜索结果页的查询。 例如,如果类别为“热门人脉搜索”,则 image 字段中的缩略图将是一名热门人员。 若要返回人员更多图像,请使用对象中的 Query 链接。 查询

TrendingImages

响应包含的趋势图像请求成功时的顶级对象。

元素 说明 类型
Categories 一个列表,用于标识图像类别以及该类别中热门图像的列表。 Category[]

错误代码

以下是请求可能返回的 HTTP 状态代码。

状态代码 说明
200 调用成功。
400 其中一个查询参数丢失或无效。
401 订阅密钥缺失或无效。
403 例如,用户经过身份验证 (使用了有效的订阅密钥) ,但他们没有请求的资源权限。

如果调用方超出每个月的查询配额,必应也可能返回此状态。
410 请求使用了 HTTP 而非 HTTPS 协议。 HTTPS 是唯一支持的协议。
429 调用方超出其每秒查询配额。

如果请求失败,响应正文将包含一个 ErrorResponse 对象。 响应对象将包含错误代码和错误说明。 如果错误与参数相关,则 parameter 字段将标识问题的参数。 如果错误与参数值相关,则 value 字段将标识无效的值。

{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "RequestParameterMissing", 
      "message": "Required parameter is missing.", 
      "parameter": "q" 
    }
  ]
}


{
  "_type": "ErrorResponse", 
  "errors": [
    {
      "code": "AuthorizationMissing", 
      "message": "Authorization is required.", 
    }
  ]
}

下面是可能的错误代码。

错误代码 说明
RequestParameterMissing 请求缺少必需的参数。 该 parameter 字段标识缺少的参数。
RequestParameterInvalidValue 参数值无效。 该 parameter 字段标识包含无效值的参数,字段 value 包含无效的值。
ResourceAccessDenied 调用方无权访问资源。 如果订阅密钥已禁用或过期,则会发生此错误。
ExceededVolume 调用方每月超过其查询, (QPM) 配额。
ExceededQpsLimit 调用方每秒超过其查询数 (QPS) 。
已禁用 调用方无权访问资源。
UnexpectedError 服务器上发生意外错误。 请稍后再试。
DataSourceErrors 访问资源时出错。
AuthorizationMissing 必应无法对调用方进行身份验证。 如果缺少标头, Ocp-Apim-Subscription-Key 则可能会发生此错误。
HttpNotAllowed 请求使用 HTTP 协议而不是 HTTPS 协议;必应仅支持 HTTPS。
InvalidAuthorization 必应无法对调用方进行身份验证。 如果订阅密钥无效,可能会发生这种情况。
InsufficientScope 调用方无权访问资源。 如果订阅密钥已过期,则可能发生此错误。

市场代码

下表列出了可用于指定 mkt 查询参数的市场代码值。 必应仅为这些市场返回内容。 列表可能随时变动。

有关可在查询参数中指定的 cc 国家/地区代码的列表,请参阅 国家/地区代码

国家/地区 语言 市场代码
阿根廷 西班牙语 es-AR
澳大利亚 英语 en-AU
奥地利 德语 de-AT
比利时 荷兰语 nl-BE
比利时 法语 fr-BE
巴西 葡萄牙语 pt-BR
加拿大 英语 en-CA
加拿大 法语 fr-CA
智利 西班牙语 es-CL
丹麦 丹麦语 da-DK
芬兰 芬兰语 fi-FI
法国 法语 fr-FR
德国 德语 de-DE
香港特别行政区 繁体中文 zh-HK
印度 英语 en-IN
印度尼西亚 英语 en-ID
意大利 意大利语 it-IT
日本 日语 ja-JP
韩国 韩语 ko-KR
马来西亚 英语 en-MY
墨西哥 西班牙语 es-MX
荷兰 荷兰语 nl-NL
新西兰 英语 en-NZ
挪威 挪威语 no-NO
中华人民共和国 中文 zh-CN
波兰 波兰语 pl-PL
菲律宾共和国 英语 en-PH
俄罗斯 俄语 ru-RU
南非 英语 en-ZA
西班牙 西班牙语 es-ES
瑞典 瑞典语 sv-SE
瑞士 法语 fr-CH
瑞士 德语 de-CH
台湾 繁体中文 zh-TW
土耳其 土耳其语 tr-TR
英国 英语 en-GB
美国 英语 zh-CN
美国 西班牙语 es-US

国家/地区代码

下面是可使用 cc 查询参数指定的国家/地区代码。 列表可能随时变动。

国家/地区 国家/地区代码
阿根廷 AR
澳大利亚 AU
奥地利 AT
比利时 BE
巴西 BR
Canada CA
智利 CL
丹麦 DK
芬兰 FI
法国 FR
德国 DE
香港特别行政区 HK
印度 IN
印度尼西亚 ID
意大利 IT
日本 JP
韩国 KR
马来西亚 MY
墨西哥 MX
荷兰 NL
新西兰 NZ
挪威
中华人民共和国 CN
波兰 PL
葡萄牙 PT
菲律宾共和国 PH
俄罗斯 RU
沙特阿拉伯 SA
南非 ZA
西班牙 ES
瑞典 SE
瑞士 CH
中国台湾 TW
土耳其 TR
United Kingdom GB
United States 美国