此页面由 Cloud Translation API 翻译。

Search

search 结果包含与 API 请求中指定的搜索参数匹配的 YouTube 视频、频道或播放列表的相关信息。虽然搜索结果指向具有唯一标识符的资源（例如视频），但它没有自己的永久性数据。

方法

该 API 支持以下搜索方法：

list: 返回与 API 请求中指定的查询参数匹配的搜索结果集合。默认情况下，搜索结果集会识别匹配的 video、channel 和 playlist 资源，但您也可以配置查询，以便仅检索特定类型的资源。立即试用。

资源表示法

以下 JSON 结构显示了搜索结果的格式：

{
  "kind": "youtube#searchResult",
  "etag": etag,
  "id": {
    "kind": string,
    "videoId": string,
    "channelId": string,
    "playlistId": string
  },
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "liveBroadcastContent": string
  }
}

属性

下表定义了搜索结果中显示的属性：

属性
`kind`	`string` 用于标识 API 资源的类型。该值将为 `youtube#searchResult`。
`etag`	`etag` 此资源的 ETag。
`id`	`object` `id` 对象包含可用于唯一标识与搜索请求匹配的资源的信息。
`id.kind`	`string` API 资源的类型。
`id.videoId`	`string` 如果 `id.type` 属性的值为 `youtube#video`，则此属性将存在，并且其值将包含 YouTube 用来唯一标识与搜索查询匹配的视频的 ID。
`id.channelId`	`string` 如果 `id.type` 属性的值为 `youtube#channel`，则此属性将存在，并且其值将包含 YouTube 用来唯一标识与搜索查询匹配的频道的 ID。
`id.playlistId`	`string` 如果 `id.type` 属性的值为 `youtube#playlist`，则此属性将存在，并且其值将包含 YouTube 用来唯一标识与搜索查询匹配的播放列表的 ID。
`snippet`	`object` `snippet` 对象包含有关搜索结果的基本详细信息，例如其标题或说明。例如，如果搜索结果是视频，则标题将是视频的标题，说明将是视频的说明。
`snippet.publishedAt`	`datetime` 搜索结果标识的资源的创建日期和时间。该值采用 ISO 8601 格式指定。
`snippet.channelId`	`string` 此值由 YouTube 用于唯一标识发布了搜索结果中所标识资源的频道。
`snippet.title`	`string` 搜索结果的标题。
`snippet.description`	`string` 搜索结果的说明。
`snippet.thumbnails`	`object` 与搜索结果相关联的缩略图的映射。对于映射中的每个对象，键是缩略图的名称，值是包含缩略图的其他信息的对象。
`snippet.thumbnails.(key)`	`object` 有效的键值包括： `default` - 默认缩略图。视频或提及视频的资源（例如播放列表项或搜索结果）的默认缩略图宽度为 120 像素，高度为 90 像素。频道的默认缩略图宽度为 88 像素，高度为 88 像素。 `medium` - 缩略图的更高分辨率版本。对于视频（或引用视频的资源），此图片的宽度为 320 像素，高度为 180 像素。对于频道，此图片的宽度为 240 像素，高度为 240 像素。 `high` - 缩略图的较高分辨率版本。对于视频（或提及视频的资源），此图片的宽度为 480 像素，高度为 360 像素。对于频道，此图片的宽度为 800 像素，高度为 800 像素。 `standard` - 比 `high` 分辨率图片分辨率更高的缩略图图片。此图片适用于某些视频以及提及视频的其他资源，例如播放列表项或搜索结果。此图片的宽度为 640 像素，高度为 480 像素。 `maxres` - 缩略图图片的分辨率最高版本。此图片尺寸适用于部分视频以及提及视频的其他资源，例如播放列表项或搜索结果。此图片的宽度为 1280 像素，高度为 720 像素。
`snippet.thumbnails.(key).url`	`string` 图片的网址。
`snippet.thumbnails.(key).width`	`unsigned integer` 图片的宽度。
`snippet.thumbnails.(key).height`	`unsigned integer` 图片的高度。
`snippet.channelTitle`	`string` 发布搜索结果中标识的资源的频道的标题。
`snippet.liveBroadcastContent`	`string` 指示 `video` 或 `channel` 资源是否包含直播内容。有效的属性值为 `upcoming`、`live` 和 `none`。对于 `video` 资源，值为 `upcoming` 表示视频是尚未开始的直播，值为 `live` 表示视频是正在进行的直播。对于 `channel` 资源，值 `upcoming` 表示频道有尚未开始的预定直播，值 `live` 表示频道有正在进行的直播。