ChannelBanners

Tài nguyên channelBanner chứa URL mà bạn sẽ dùng để đặt hình ảnh mới tải lên làm ảnh biểu ngữ cho kênh.

Phương thức

API hỗ trợ các phương thức sau cho tài nguyên channelBanners:

chèn
Tải ảnh biểu ngữ kênh lên YouTube. Phương pháp này thể hiện hai bước đầu tiên trong quy trình 3 bước để cập nhật ảnh biểu ngữ cho kênh:

  1. Gọi phương thức channelBanners.insert để tải dữ liệu hình ảnh nhị phân lên YouTube. Hình ảnh phải có tỷ lệ khung hình 16:9 và có kích thước tối thiểu là 2048x1152 pixel. Bạn nên tải hình ảnh có kích thước 2560 px x 1440 px lên.
  2. Trích xuất giá trị của thuộc tính url từ phản hồi mà API trả về cho bước 1.
  3. Gọi phương thức channels.update để cập nhật chế độ cài đặt thương hiệu của kênh. Đặt giá trị của thuộc tính brandingSettings.image.bannerExternalUrl thành URL thu được ở bước 2.

Trình bày tài nguyên

Cấu trúc JSON dưới đây thể hiện định dạng của tài nguyên channelBanners:

{
  "kind": "youtube#channelBannerResource",
  "etag": etag,
  "url": string
}

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#channelBannerResource.
etag etag
Thẻ Etag của tài nguyên này.
url string
URL của ảnh biểu ngữ. Sau khi gọi phương thức channelBanners.insert, hãy trích xuất giá trị này từ phản hồi của API. Sau đó, gọi phương thức channels.update và thiết lập URL làm giá trị của thuộc tính brandingSettings.image.bannerExternalUrl để đặt ảnh biểu ngữ cho một kênh.