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

提供要在文档中检查的其他搜索字词，其中，搜索结果中的每个文档必须至少包含 1 个其他搜索字词。您也可以将布尔值 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 闪烁 (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

提供要在文档中检查的其他搜索字词，其中，搜索结果中的每个文档必须至少包含 1 个其他搜索字词。您也可以将布尔值 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 闪烁 (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

提供要在文档中检查的其他搜索字词，其中，搜索结果中的每个文档必须至少包含 1 个其他搜索字词。您也可以将布尔值 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 闪烁 (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

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