本頁面由 Cloud Translation API 翻譯而成。

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`，則代表頻道有正在進行的現場直播。