Search

响应自定义搜索请求。

JSON 表示法 
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
字段
kind

string

当前对象类型的唯一标识符。对于此 API，即为 customsearch#search。
url

object

定义此 API 模板的 OpenSearch 网址元素。
url.type

string

Custom Search JSON API 的 OpenSearch 网址模板的 MIME 类型。
url.template

string

此 API 的实际 OpenSearch 模板。
queries

object

包含一个或多个由角色名称键控的查询元数据集。可能的角色名称包括由 OpenSearch 查询角色定义的 request 和两个自定义角色：nextPage 和 previousPage。
queries.previousPage[]

object

表示上一页的元数据（如果适用）。
queries.previousPage[].title

string

查询的说明。
queries.previousPage[].totalResults

string (int64 format)

搜索结果总数的估算值。可能不准确。
queries.previousPage[].searchTerms

string

用户输入的搜索字词。
queries.previousPage[].count

integer

在此集中返回的搜索结果数量。
queries.previousPage[].startIndex

integer

当前搜索结果集在总结果集中的索引，其中第一个结果的索引为 1。
queries.previousPage[].startPage

integer

此组结果的页码，其中页面长度由 count 属性设置。
queries.previousPage[].language

string

搜索结果的语言。
queries.previousPage[].inputEncoding

string

支持搜索请求的字符编码。
queries.previousPage[].outputEncoding

string

搜索结果支持的字符编码。
queries.previousPage[].safe

string

指定用于滤除成人结果的安全搜索级别。这是未在 OpenSearch 规范中定义的自定义属性。有效的参数值包括：

  • "off"：停用安全搜索

  • "active"：启用安全搜索
queries.previousPage[].cx

string

使用可编程搜索引擎控制面板创建的引擎的标识符。这是未在 OpenSearch 规范中定义的自定义属性。此参数是必需参数。
queries.previousPage[].sort

string

指定应根据指定表达式对结果进行排序。例如，按日期排序。
queries.previousPage[].filter

string

启用或停用 Google 搜索结果自动过滤功能。有关 Google 搜索结果过滤器的详情，请参阅自动过滤。此参数的有效值包括：

  • 0：已停用

  • 1：已启用（默认）

注意：默认情况下，Google 会对所有搜索结果应用过滤条件，以提高这些结果的质量。
queries.previousPage[].gl

string

提升来源国家/地区与参数值相匹配的搜索结果。如需查看有效值列表，请参阅国家/地区代码。

在 WebSearch 请求中指定 gl 参数值应该会提高结果的相关性。对于国际客户来说尤其如此，尤其是美国以外的英语国家/地区的客户。
queries.previousPage[].cr

string

将搜索结果限制为来自特定国家/地区的文档。您可以在 cr 参数的值中使用布尔值运算符。

Google WebSearch 通过分析以下内容来确定文档所在的国家/地区：

  • 文档网址的顶级域名 (TLD)。

  • Web 服务器的 IP 地址的地理位置。

如需查看此参数的有效值列表，请参阅国家/地区 (cr) 参数值。
queries.previousPage[].googleHost

string

指定应将搜索限制到哪个 Google 网域（例如 google.com、google.de 或 google.fr）。
queries.previousPage[].disableCnTwTranslation

string

启用或停用简体中文和繁体中文搜索功能。

支持的值包括：

  • 0：已启用（默认）

  • 1：已停用
queries.previousPage[].hq

string

向查询附加指定的查询字词，就像使用逻辑 AND 运算符对这些字词进行了组合一样。
queries.previousPage[].hl

string

指定界面的界面语言（主语言）。明确设置此参数可提高搜索结果的效果和质量。

如需了解详情，请参阅国际化查询和结果呈现的界面语言部分；如需了解受支持语言的列表，请参阅支持的界面语言。
queries.previousPage[].siteSearch

string

将结果限制为来自指定网站的网址。
queries.previousPage[].siteSearchFilter

string

指定是包含还是排除 sitesearch 参数中指定的网站的结果。支持的值包括：

  • i：包含网站内容

  • e：从网站上排除内容
queries.previousPage[].exactTerms

string

标识搜索结果中所有文档必须包含的词组。
queries.previousPage[].excludeTerms

string

标识不应在搜索结果的任何文档中出现的字词或词组。
queries.previousPage[].linkSite

string

指定所有结果都应包含指向特定网址的链接。
queries.previousPage[].orTerms

string

提供要在文档中检查的其他搜索字词，其中搜索结果中的每个文档都必须至少包含一个其他搜索字词。对于此类查询，您也可以使用布尔值 OR 查询字词。
queries.previousPage[].relatedSite

string

指定所有搜索结果都应是与指定网址相关的网页。参数值应为网址。
queries.previousPage[].dateRestrict

string

根据日期将结果限制为网址。支持的值包括：

  • d[number]：请求过去指定天数的结果。

  • w[number]：请求过去指定周数的结果。

  • m[number]：请求过去指定月份数的结果。

  • y[number]：请求过去指定年份的结果。
queries.previousPage[].lowRange

string

指定搜索范围的起始值。使用 cse:lowRange 和 cse:highrange 可为查询附加 lowRange...highRange 的包容性搜索范围。
queries.previousPage[].highRange

string

指定搜索范围的结束值。使用 cse:lowRange 和 cse:highrange 可为查询附加 lowRange...highRange 的包容性搜索范围。
queries.previousPage[].fileType

string

将结果限制为指定扩展名的文件。Google 支持的文件类型包括：

  • Adobe 便携式文档格式 (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3（wk1、wk2、wk3、wk4、wk5、wki、wks、wku）

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint 文件 (ppt)

  • Microsoft Word (doc)

  • Microsoft Works（wks、wps、wdb）

  • Microsoft Write (wri)

  • 富文本格式 (rtf)

  • Shockwave Flash (swf)

  • 文本（ans，txt）。

日后我们可能会添加更多文件类型。您可以随时通过 Google 的文件类型常见问题解答找到最新列表。
queries.previousPage[].rights

string

基于许可的过滤条件。支持的值包括：

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.previousPage[].searchType

string

允许的值为 web 或 image。如果未指定，则结果将仅限于网页。
queries.previousPage[].imgSize

string

将结果限制为指定大小的图片。支持的值包括：

  • icon（小）

  • small | medium | large | xlarge（中）

  • xxlarge（大）

  • huge（超大）
queries.previousPage[].imgType

string

将结果限制为指定类型的图片。支持的值包括：

  • clipart（剪贴画）

  • face（人脸）

  • lineart（线条画）

  • photo（照片）

  • animated（动画）

  • stock（库存）
queries.previousPage[].imgColorType

string

将结果限制为指定颜色类型的图片。支持的值包括：

  • mono（黑白）

  • gray（灰度模式）

  • color（颜色）
queries.previousPage[].imgDominantColor

string

将结果限制为具有特定主色的图片。支持的值包括：

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
queries.request[]

object

表示当前请求的元数据。
queries.request[].title

string

查询的说明。
queries.request[].totalResults

string (int64 format)

搜索结果总数的估算值。可能不准确。
queries.request[].searchTerms

string

用户输入的搜索字词。
queries.request[].count

integer

在此集中返回的搜索结果数量。
queries.request[].startIndex

integer

当前搜索结果集在总结果集中的索引，其中第一个结果的索引为 1。
queries.request[].startPage

integer

此组结果的页码，其中页面长度由 count 属性设置。
queries.request[].language

string

搜索结果的语言。
queries.request[].inputEncoding

string

支持搜索请求的字符编码。
queries.request[].outputEncoding

string

搜索结果支持的字符编码。
queries.request[].safe

string

指定用于滤除成人结果的安全搜索级别。这是未在 OpenSearch 规范中定义的自定义属性。有效的参数值包括：

  • "off"：停用安全搜索

  • "active"：启用安全搜索
queries.request[].cx

string

使用可编程搜索引擎控制面板创建的引擎的标识符。这是未在 OpenSearch 规范中定义的自定义属性。此参数是必需参数。
queries.request[].sort

string

指定应根据指定表达式对结果进行排序。例如，按日期排序。
queries.request[].filter

string

启用或停用 Google 搜索结果自动过滤功能。有关 Google 搜索结果过滤器的详情，请参阅自动过滤。此参数的有效值包括：

  • 0：已停用

  • 1：已启用（默认）

注意：默认情况下，Google 会对所有搜索结果应用过滤条件，以提高这些结果的质量。
queries.request[].gl

string

提升来源国家/地区与参数值相匹配的搜索结果。如需查看有效值列表，请参阅国家/地区代码。

在 WebSearch 请求中指定 gl 参数值应该会提高结果的相关性。对于国际客户来说尤其如此，尤其是美国以外的英语国家/地区的客户。
queries.request[].cr

string

将搜索结果限制为来自特定国家/地区的文档。您可以在 cr 参数的值中使用布尔值运算符。

Google WebSearch 通过分析以下内容来确定文档所在的国家/地区：

  • 文档网址的顶级域名 (TLD)。

  • Web 服务器的 IP 地址的地理位置。

如需查看此参数的有效值列表，请参阅国家/地区 (cr) 参数值。
queries.request[].googleHost

string

指定应将搜索限制到哪个 Google 网域（例如 google.com、google.de 或 google.fr）。
queries.request[].disableCnTwTranslation

string

启用或停用简体中文和繁体中文搜索功能。

支持的值包括：

  • 0：已启用（默认）

  • 1：已停用
queries.request[].hq

string

向查询附加指定的查询字词，就像使用逻辑 AND 运算符对这些字词进行了组合一样。
queries.request[].hl

string

指定界面的界面语言（主语言）。明确设置此参数可提高搜索结果的效果和质量。

如需了解详情，请参阅国际化查询和结果呈现的界面语言部分；如需了解受支持语言的列表，请参阅支持的界面语言。
queries.request[].siteSearch

string

将结果限制为来自指定网站的网址。
queries.request[].siteSearchFilter

string

指定是包含还是排除 sitesearch 参数中指定的网站的结果。支持的值包括：

  • i：包含网站内容

  • e：从网站上排除内容
queries.request[].exactTerms

string

标识搜索结果中所有文档必须包含的词组。
queries.request[].excludeTerms

string

标识不应在搜索结果的任何文档中出现的字词或词组。
queries.request[].linkSite

string

指定所有结果都应包含指向特定网址的链接。
queries.request[].orTerms

string

提供要在文档中检查的其他搜索字词，其中搜索结果中的每个文档都必须至少包含一个其他搜索字词。对于此类查询，您也可以使用布尔值 OR 查询字词。
queries.request[].relatedSite

string

指定所有搜索结果都应是与指定网址相关的网页。参数值应为网址。
queries.request[].dateRestrict

string

根据日期将结果限制为网址。支持的值包括：

  • d[number]：请求过去指定天数的结果。

  • w[number]：请求过去指定周数的结果。

  • m[number]：请求过去指定月份数的结果。

  • y[number]：请求过去指定年份的结果。
queries.request[].lowRange

string

指定搜索范围的起始值。使用 cse:lowRange 和 cse:highrange 可为查询附加 lowRange...highRange 的包容性搜索范围。
queries.request[].highRange

string

指定搜索范围的结束值。使用 cse:lowRange 和 cse:highrange 可为查询附加 lowRange...highRange 的包容性搜索范围。
queries.request[].fileType

string

将结果限制为指定扩展名的文件。Google 支持的文件类型包括：

  • Adobe 便携式文档格式 (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3（wk1、wk2、wk3、wk4、wk5、wki、wks、wku）

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint 文件 (ppt)

  • Microsoft Word (doc)

  • Microsoft Works（wks、wps、wdb）

  • Microsoft Write (wri)

  • 富文本格式 (rtf)

  • Shockwave Flash (swf)

  • 文本（ans，txt）。

日后我们可能会添加更多文件类型。您可以随时通过 Google 的文件类型常见问题解答找到最新列表。
queries.request[].rights

string

基于许可的过滤条件。支持的值包括：

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.request[].searchType

string

允许的值为 web 或 image。如果未指定，则结果将仅限于网页。
queries.request[].imgSize

string

将结果限制为指定大小的图片。支持的值包括：

  • icon（小）

  • small | medium | large | xlarge（中）

  • xxlarge（大）

  • huge（超大）
queries.request[].imgType

string

将结果限制为指定类型的图片。支持的值包括：

  • clipart（剪贴画）

  • face（人脸）

  • lineart（线条图）

  • photo（照片）

  • animated（动画）

  • stock（库存）
queries.request[].imgColorType

string

将结果限制为指定颜色类型的图片。支持的值包括：

  • mono（黑白）

  • gray（灰度模式）

  • color（颜色）
queries.request[].imgDominantColor

string

将结果限制为具有特定主色的图片。支持的值包括：

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
queries.nextPage[]

object

表示下一页结果的元数据（如果适用）。
queries.nextPage[].title

string

查询的说明。
queries.nextPage[].totalResults

string (int64 format)

搜索结果总数的估算值。可能不准确。
queries.nextPage[].searchTerms

string

用户输入的搜索字词。
queries.nextPage[].count

integer

在此集中返回的搜索结果数量。
queries.nextPage[].startIndex

integer

当前搜索结果集在总结果集中的索引，其中第一个结果的索引为 1。
queries.nextPage[].startPage

integer

此组结果的页码，其中页面长度由 count 属性设置。
queries.nextPage[].language

string

搜索结果的语言。
queries.nextPage[].inputEncoding

string

支持搜索请求的字符编码。
queries.nextPage[].outputEncoding

string

搜索结果支持的字符编码。
queries.nextPage[].safe

string

指定用于滤除成人结果的安全搜索级别。这是未在 OpenSearch 规范中定义的自定义属性。有效的参数值包括：

  • "off"：停用安全搜索

  • "active"：启用安全搜索
queries.nextPage[].cx

string

使用可编程搜索引擎控制面板创建的引擎的标识符。这是未在 OpenSearch 规范中定义的自定义属性。此参数是必需参数。
queries.nextPage[].sort

string

指定应根据指定表达式对结果进行排序。例如，按日期排序。
queries.nextPage[].filter

string

启用或停用 Google 搜索结果自动过滤功能。有关 Google 搜索结果过滤器的详情，请参阅自动过滤。此参数的有效值包括：

  • 0：已停用

  • 1：已启用（默认）

注意：默认情况下，Google 会对所有搜索结果应用过滤条件，以提高这些结果的质量。
queries.nextPage[].gl

string

提升来源国家/地区与参数值相匹配的搜索结果。如需查看有效值列表，请参阅国家/地区代码。

在 WebSearch 请求中指定 gl 参数值应该会提高结果的相关性。对于国际客户来说尤其如此，尤其是美国以外的英语国家/地区的客户。
queries.nextPage[].cr

string

将搜索结果限制为来自特定国家/地区的文档。您可以在 cr 参数的值中使用布尔值运算符。

Google WebSearch 通过分析以下内容来确定文档所在的国家/地区：

  • 文档网址的顶级域名 (TLD)。

  • Web 服务器的 IP 地址的地理位置。

如需查看此参数的有效值列表，请参阅国家/地区 (cr) 参数值。
queries.nextPage[].googleHost

string

指定应将搜索限制到哪个 Google 网域（例如 google.com、google.de 或 google.fr）。
queries.nextPage[].disableCnTwTranslation

string

启用或停用简体中文和繁体中文搜索功能。

支持的值包括：

  • 0：已启用（默认）

  • 1：已停用
queries.nextPage[].hq

string

向查询附加指定的查询字词，就像使用逻辑 AND 运算符对这些字词进行了组合一样。
queries.nextPage[].hl

string

指定界面的界面语言（主语言）。明确设置此参数可提高搜索结果的效果和质量。

如需了解详情，请参阅国际化查询和结果呈现的界面语言部分；如需了解受支持语言的列表，请参阅支持的界面语言。
queries.nextPage[].siteSearch

string

将结果限制为来自指定网站的网址。
queries.nextPage[].siteSearchFilter

string

指定是包含还是排除 sitesearch 参数中指定的网站的结果。支持的值包括：

  • i：包含网站内容

  • e：从网站上排除内容
queries.nextPage[].exactTerms

string

标识搜索结果中所有文档必须包含的词组。
queries.nextPage[].excludeTerms

string

标识不应在搜索结果的任何文档中出现的字词或词组。
queries.nextPage[].linkSite

string

指定所有结果都应包含指向特定网址的链接。
queries.nextPage[].orTerms

string

提供要在文档中检查的其他搜索字词，其中搜索结果中的每个文档都必须至少包含一个其他搜索字词。对于此类查询，您也可以使用布尔值 OR 查询字词。
queries.nextPage[].relatedSite

string

指定所有搜索结果都应是与指定网址相关的网页。参数值应为网址。
queries.nextPage[].dateRestrict

string

根据日期将结果限制为网址。支持的值包括：

  • d[number]：请求过去指定天数的结果。

  • w[number]：请求过去指定周数的结果。

  • m[number]：请求过去指定月份数的结果。

  • y[number]：请求过去指定年份的结果。
queries.nextPage[].lowRange

string

指定搜索范围的起始值。使用 cse:lowRange 和 cse:highrange 可为查询附加 lowRange...highRange 的包容性搜索范围。
queries.nextPage[].highRange

string

指定搜索范围的结束值。使用 cse:lowRange 和 cse:highrange 可为查询附加 lowRange...highRange 的包容性搜索范围。
queries.nextPage[].fileType

string

将结果限制为指定扩展名的文件。Google 支持的文件类型包括：

  • Adobe 便携式文档格式 (pdf)

  • Adobe PostScript (ps)

  • Lotus 1-2-3（wk1、wk2、wk3、wk4、wk5、wki、wks、wku）

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint 文件 (ppt)

  • Microsoft Word (doc)

  • Microsoft Works（wks、wps、wdb）

  • Microsoft Write (wri)

  • 富文本格式 (rtf)

  • Shockwave Flash (swf)

  • 文本（ans，txt）。

日后我们可能会添加更多文件类型。您可以随时通过 Google 的文件类型常见问题解答找到最新列表。
queries.nextPage[].rights

string

基于许可的过滤条件。支持的值包括：

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.nextPage[].searchType

string

允许的值为 web 或 image。如果未指定，则结果将仅限于网页。
queries.nextPage[].imgSize

string

将结果限制为指定大小的图片。支持的值包括：

  • icon（小）

  • small | medium | large | xlarge（中）

  • xxlarge（大）

  • huge（超大）
queries.nextPage[].imgType

string

将结果限制为指定类型的图片。支持的值包括：

  • clipart（剪贴画）

  • face（人脸）

  • lineart（线条图）

  • photo（照片）

  • animated（动画）

  • stock（库存）
queries.nextPage[].imgColorType

string

将结果限制为指定颜色类型的图片。支持的值包括：

  • mono（黑白）

  • gray（灰度模式）

  • color（颜色）
queries.nextPage[].imgDominantColor

string

将结果限制为具有特定主色的图片。支持的值包括：

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
promotions[]

object (Promotion)

一组促销活动。仅当自定义搜索引擎的配置文件为指定查询定义任何置顶结果时，此字段才会显示。
context

object (Struct format)

与指定搜索引擎关联的元数据和优化内容，包括：

  • 用于执行查询的搜索引擎的名称。

  • 一组可用于优化搜索的构面对象（优化）。
searchInformation

object

关于此搜索的元数据，包括搜索时间和搜索结果总数。
searchInformation.searchTime

number

服务器返回搜索结果所用的时间。
searchInformation.formattedSearchTime

string

服务器返回搜索结果所用的时间，其格式取决于语言区域样式。
searchInformation.totalResults

string

查询返回的搜索结果总数。
searchInformation.formattedTotalResults

string

根据语言区域样式设置的搜索结果总数。
spelling

object

封装更正后的查询。
spelling.correctedQuery

string

更正后的查询。
spelling.htmlCorrectedQuery

string

已更正的查询，采用 HTML 格式。
items[]

object (Result)

当前自定义搜索结果集。

促销

促销结果。

JSON 表示法 
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
字段
title

string

促销活动的标题。
htmlTitle

string

促销活动的标题，采用 HTML 格式。
bodyLines[]

object

此推广活动的一组块对象。
bodyLines[].title

string

阻止对象的文本（如果阻止对象包含文本）。
bodyLines[].htmlTitle

string

块对象的 HTML 文本（如果包含文本）。
bodyLines[].url

string

阻止对象的链接网址（如果有）。
bodyLines[].link

string

阻止对象的链接的定位文字（如果阻止对象包含链接）。
image

object

与此促销活动关联的图片（如果有）。
image.source

string

此推广链接的图片的网址。
image.width

integer

图片宽度（以像素为单位）。
image.height

integer

图片高度（以像素为单位）。

结果

自定义搜索结果。

JSON 表示法 
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
字段
kind

string

当前对象类型的唯一标识符。对于此 API，其值为 customsearch#result.
title

string

搜索结果的标题（纯文本格式）。
htmlTitle

string

搜索结果的标题（HTML 格式）。
snippet

string

搜索结果的摘要（纯文本格式）。
htmlSnippet

string

搜索结果的摘要（HTML 格式）。
cacheId

string

指示搜索结果的 Google 缓存版本的 ID。
formattedUrl

string

每个搜索结果摘要之后显示的网址。
htmlFormattedUrl

string

显示在每个搜索结果摘要之后的 HTML 格式的网址。
pagemap

object (Struct format)

包含该搜索结果的 PageMap 信息。
mime

string

搜索结果的 MIME 类型。
fileFormat

string

搜索结果的文件格式。
image

object

封装搜索结果中返回的图片的所有相关信息。
image.contextLink

string

指向图片托管网页的网址。
image.height

integer

图片的高度，以像素为单位。
image.width

integer

图片的宽度（以像素为单位）。
image.byteSize

integer

图片的大小（以字节为单位）。
image.thumbnailLink

string

指向缩略图的网址。
image.thumbnailHeight

integer

缩略图的高度（以像素为单位）。
image.thumbnailWidth

integer

缩略图的宽度（以像素为单位）。
labels[]

object

封装优化标签的所有相关信息。
labels[].name

string

优化标签的名称，可用于优化搜索。请勿在界面中显示此名称，而应使用 displayName。
labels[].displayName

string

优化标签的显示名称。这是您应该在界面中显示的名称。
labels[].label_with_op

string

优化标签和关联的优化操作。