Thumbnails: set

Tải hình thu nhỏ tùy chỉnh của video lên YouTube và đặt hình thu nhỏ đó cho video.

Phương thức này hỗ trợ việc tải nội dung nghe nhìn lên. Tệp đã tải lên phải tuân thủ những quy định ràng buộc sau:

  • Kích thước tệp tối đa: 2 MB
  • Các loại MIME nội dung đa phương tiện được chấp nhận: image/jpeg, image/png, application/octet-stream

Tác động hạn mức: Một lệnh gọi đến phương thức này có chi phí định mức khoảng 50 đơn vị.

Các trường hợp sử dụng phổ biến

Yêu cầu

Yêu cầu HTTP

POST https://www.googleapis.com/upload/youtube/v3/thumbnails/set

Ủy quyền

Yêu cầu này yêu cầu ủy quyền với ít nhất một trong các phạm vi sau (đọc thêm về xác thực và ủy quyền).

Phạm vi
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube.upload
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Các tham số

Bảng sau liệt kê các tham số mà truy vấn này hỗ trợ. Tất cả tham số được liệt kê đều là tham số truy vấn.

Các tham số
Tham số bắt buộc
videoId string
Thông số videoId chỉ định một mã video trên YouTube mà bạn đang cung cấp hình thu nhỏ video tùy chỉnh.
Tham số không bắt buộc
onBehalfOfContentOwner string
Lưu ý: Tham số này chỉ dành riêng cho các đối tác nội dung của YouTube.

Tham số onBehalfOfContentOwner cho biết thông tin xác thực ủy quyền của yêu cầu giúp xác định một người dùng YouTube CMS đang thay mặt chủ sở hữu nội dung được chỉ định trong giá trị tham số. Thông số này dành cho các đối tác nội dung của YouTube sở hữu và quản lý nhiều kênh YouTube khác nhau. Tính năng này cho phép chủ sở hữu nội dung xác thực một lần và có quyền truy cập vào tất cả dữ liệu video và kênh của họ mà không phải cung cấp thông tin xác thực cho từng kênh. Tài khoản CMS thực tế mà người dùng xác thực phải được liên kết với chủ sở hữu nội dung YouTube đã chỉ định.

Nội dung yêu cầu

Nội dung của yêu cầu có chứa hình ảnh thu nhỏ mà bạn đang tải lên. Nội dung yêu cầu không chứa tài nguyên thumbnail.

Phản hồi

Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc sau:

{
  "kind": "youtube#thumbnailSetResponse",
  "etag": etag,
  "items": [
    thumbnail resource
  ]
}

Thuộc tính

Bảng sau đây xác định các thuộc tính xuất hiện trong tài nguyên này:

Thuộc tính
kind string
Xác định loại tài nguyên API. Giá trị sẽ là youtube#thumbnailSetResponse.
etag etag
Etag của tài nguyên này.
items[] list
Danh sách hình thu nhỏ.

Lỗi

Bảng sau đây xác định các thông báo lỗi mà API có thể trả về để phản hồi lệnh gọi phương thức này. Vui lòng xem tài liệu thông báo lỗi để biết thêm chi tiết.

Loại lỗi Chi tiết lỗi Mô tả
badRequest (400) invalidImage Nội dung hình ảnh đã cung cấp không hợp lệ.
badRequest (400) mediaBodyRequired Yêu cầu này không bao gồm nội dung hình ảnh.
forbidden (403) forbidden Không thể đặt hình thu nhỏ cho video đã chỉ định. Yêu cầu có thể không được cấp phép đúng cách.
forbidden (403) forbidden Người dùng được xác thực không có quyền tải lên và đặt hình thu nhỏ video tùy chỉnh.
notFound (404) videoNotFound Không thể tìm thấy video bạn đang cố chèn hình thu nhỏ. Hãy kiểm tra giá trị của tham số videoId của yêu cầu để đảm bảo rằng tham số đó là chính xác.
tooManyRequests (429) uploadRateLimitExceeded Gần đây, kênh đã tải quá nhiều hình thu nhỏ lên. Vui lòng thử yêu cầu lại sau.

Hãy dùng thử!

Hãy sử dụng APIs Explorer để gọi API này cũng như xem yêu cầu và phản hồi của API đó.