Search

Kết quả search chứa thông tin về một video, kênh hoặc danh sách phát trên YouTube khớp với các thông số tìm kiếm được chỉ định trong một yêu cầu API. Mặc dù một kết quả tìm kiếm trỏ đến một tài nguyên có thể nhận dạng riêng biệt (chẳng hạn như một video), nhưng kết quả tìm kiếm đó không có dữ liệu cố định riêng.

Phương thức

API này hỗ trợ các phương thức tìm kiếm sau:

list

Trả về một tập hợp kết quả tìm kiếm khớp với các tham số truy vấn được chỉ định trong yêu cầu API. Theo mặc định, tập hợp kết quả tìm kiếm sẽ xác định các tài nguyên video, channel và playlist trùng khớp, nhưng bạn cũng có thể định cấu hình truy vấn để chỉ truy xuất một loại tài nguyên cụ thể. Thử ngay.

Biểu thị tài nguyên

Cấu trúc JSON sau đây cho thấy định dạng của một kết quả tìm kiếm:

{
  "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
  }
}

Thuộc tính

Bảng sau đây xác định các thuộc tính xuất hiện trong kết quả tìm kiếm: