Search

Kết quả search chứa thông tin về một video trên YouTube, kênh hoặc danh sách phát phù hợ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ù kết quả tìm kiếm trỏ đến một tài nguyên có thể nhận dạng chính xác (chẳng hạn như video), nhưng kết quả tìm kiếm không có dữ liệu liên tục 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 phù hợp với các tham số truy vấn được chỉ định trong yêu cầu API. Theo mặc định, một 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 phù hợp, nhưng bạn cũng có thể định cấu hình các truy vấn để chỉ truy xuất một loại tài nguyên cụ thể. Thử ngay.

Cách trình bày 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:

Thuộc tính
kind	string Xác định loại tài nguyên API. Giá trị sẽ là youtube#searchResult.
etag	etag Etag của tài nguyên này.
id	object Đối tượng id chứa thông tin có thể dùng để xác định riêng biệt tài nguyên khớp với yêu cầu tìm kiếm.
id.kind	string Loại tài nguyên API.
id.videoId	string Nếu giá trị của thuộc tính id.type là youtube#video, thì thuộc tính này sẽ xuất hiện và giá trị của thuộc tính này sẽ chứa mã nhận dạng mà YouTube dùng để nhận dạng duy nhất một video khớp với cụm từ tìm kiếm.
id.channelId	string Nếu giá trị của thuộc tính id.type là youtube#channel, thì thuộc tính này sẽ xuất hiện và giá trị của thuộc tính này sẽ chứa mã nhận dạng mà YouTube dùng để xác định duy nhất một kênh khớp với cụm từ tìm kiếm.
id.playlistId	string Nếu giá trị của thuộc tính id.type là youtube#playlist, thì thuộc tính này sẽ xuất hiện và giá trị của thuộc tính này sẽ chứa mã nhận dạng mà YouTube dùng để nhận dạng duy nhất một danh sách phát khớp với cụm từ tìm kiếm.
snippet	object Đối tượng snippet chứa các thông tin cơ bản về một kết quả tìm kiếm, chẳng hạn như tiêu đề hoặc nội dung mô tả của kết quả đó. Ví dụ: Nếu kết quả tìm kiếm là một video, thì tiêu đề sẽ là tiêu đề của video và nội dung mô tả sẽ là nội dung mô tả của video.
snippet.publishedAt	datetime Ngày và giờ tạo tài nguyên mà kết quả tìm kiếm xác định. Giá trị được chỉ định ở định dạng ISO 8601.
snippet.channelId	string Giá trị mà YouTube dùng để xác định duy nhất kênh đã xuất bản tài nguyên mà kết quả tìm kiếm xác định.
snippet.title	string Tiêu đề của kết quả tìm kiếm.
snippet.description	string Nội dung mô tả về kết quả tìm kiếm.
snippet.thumbnails	object Bản đồ gồm các hình thu nhỏ liên kết với kết quả tìm kiếm. Đối với mỗi đối tượng trong bản đồ, khoá là tên của hình thu nhỏ và giá trị là một đối tượng chứa thông tin khác về hình thu nhỏ.
snippet.thumbnails.(key)	object Các giá trị khoá hợp lệ là: default – Hình thu nhỏ mặc định. Hình thu nhỏ mặc định cho một video (hoặc một tài nguyên đề cập đến video, chẳng hạn như mục trong danh sách phát hoặc kết quả tìm kiếm) có chiều rộng 120 pixel và chiều cao 90 pixel. Hình thu nhỏ mặc định của kênh có kích thước rộng 88 pixel và cao 88 pixel. medium – Phiên bản có độ phân giải cao hơn của hình thu nhỏ. Đối với video (hoặc tài nguyên đề cập đến video), hình ảnh này có chiều rộng 320 px và chiều cao 180 px. Đối với kênh, hình ảnh này có chiều rộng 240 px và chiều cao 240 px. high – Phiên bản có độ phân giải cao của hình thu nhỏ. Đối với video (hoặc tài nguyên đề cập đến video), hình ảnh này có chiều rộng 480 pixel và chiều cao 360 pixel. Đối với kênh, hình ảnh này có chiều rộng 800px và chiều cao 800px. standard – Phiên bản hình thu nhỏ có độ phân giải cao hơn cả hình ảnh có độ phân giải high. Hình ảnh này xuất hiện ở một số video và các tài nguyên khác có liên quan đến video, chẳng hạn như mục trong danh sách phát hoặc kết quả tìm kiếm. Hình ảnh này có chiều rộng 640px và chiều cao 480px. maxres – Phiên bản có độ phân giải cao nhất của hình thu nhỏ. Kích thước hình ảnh này có ở một số video và các tài nguyên khác có liên quan đến video, chẳng hạn như các mục trong danh sách phát hoặc kết quả tìm kiếm. Hình ảnh này có chiều rộng 1280px và chiều cao 720px. Lưu ý: Kết quả tìm kiếm không hỗ trợ hình thu nhỏ có độ phân giải từ 1080p trở lên (fhd, qhd và uhd). Để truy xuất hình thu nhỏ có độ phân giải cao hơn, hãy gọi điểm cuối dành riêng cho tài nguyên (chẳng hạn như videos.list) bằng mã nhận dạng của tài nguyên.
snippet.thumbnails.(key).url	string URL của hình ảnh.
snippet.thumbnails.(key).width	unsigned integer Chiều rộng của hình ảnh.
snippet.thumbnails.(key).height	unsigned integer Chiều cao của hình ảnh.
snippet.channelTitle	string Tiêu đề của kênh xuất bản tài nguyên mà kết quả tìm kiếm xác định.
snippet.liveBroadcastContent	string Thông tin cho biết liệu tài nguyên video hay channel có nội dung phát sóng trực tiếp hay không. Các giá trị hợp lệ của thuộc tính là upcoming, live và none. Đối với tài nguyên video, giá trị upcoming cho biết video là một chương trình phát sóng trực tiếp chưa bắt đầu, trong khi giá trị live cho biết video là một chương trình phát sóng trực tiếp đang diễn ra. Đối với tài nguyên channel, giá trị upcoming cho biết kênh có một chương trình phát sóng theo lịch chưa bắt đầu, trong khi giá trị live cho biết kênh có một chương trình phát sóng trực tiếp đang diễn ra.