Tài nguyên channelSection
chứa thông tin về một tập hợp video mà một kênh đã chọn giới thiệu. Ví dụ: một phần có thể giới thiệu video tải lên mới nhất của kênh, video tải lên phổ biến nhất hoặc video từ một hoặc nhiều danh sách phát.
Một kênh có thể tạo tối đa 10 kệ.
Phương thức
API hỗ trợ các phương thức sau cho tài nguyên channelSections
:
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 channelSections
:
{ "kind": "youtube#channelSection", "etag": etag, "id": string, "snippet": { "type": string, "channelId": string, "title": string, "position": unsigned integer }, "contentDetails": { "playlists": [ string ], "channels": [ 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#channelSection . |
etag |
etag Thẻ Etag của tài nguyên này. |
id |
string Mã nhận dạng mà YouTube dùng để xác định riêng phần kênh. |
snippet |
object Đối tượng snippet chứa các thông tin chi tiết cơ bản về phần kênh, chẳng hạn như loại và tiêu đề. |
snippet.type |
string Loại của phần kênh. Các giá trị hợp lệ cho thuộc tính này là:
|
snippet.channelId |
string Mã nhận dạng mà YouTube dùng để xác định riêng biệt kênh đã xuất bản phần kênh đó. |
snippet.title |
string Tiêu đề của mục. Bạn chỉ có thể đặt tiêu đề cho một phần kênh có giá trị snippet.type là multiplePlaylists hoặc multipleChannels . Trên thực tế, bạn phải chỉ định tiêu đề khi chèn hoặc cập nhật một trong hai loại phần đó. Nếu bạn chỉ định tiêu đề cho các loại phần kênh khác, thì giá trị này sẽ bị bỏ qua.Giá trị của tài sản này có độ dài tối đa là 100 ký tự và có thể chứa tất cả ký tự UTF-8 hợp lệ, ngoại trừ < và >. |
snippet.position |
unsigned integer Vị trí của phần đó trên trang kênh. Thuộc tính này sử dụng chỉ mục dựa trên 0. Giá trị 0 xác định phần đầu tiên xuất hiện trên kênh, giá trị 1 xác định phần thứ hai, v.v.Nếu bạn không chỉ định giá trị cho thuộc tính này khi chèn một phần kênh, thì hành vi mặc định sẽ là hiển thị phần mới sau cùng. |
contentDetails |
object Đối tượng contentDetails chứa thông tin chi tiết về nội dung của phần kênh, chẳng hạn như danh sách các danh sách phát hoặc kênh nổi bật trong phần đó. |
contentDetails.playlists[] |
list Danh sách một hoặc nhiều mã nhận dạng danh sách phát xuất hiện trong một phần kênh. Bạn phải chỉ định danh sách mã danh sách phát nếu thuộc tính snippet.type của tài nguyên channelSection là singlePlaylist hoặc multiplePlaylists . Ngoài ra, bạn không được chỉ định thuộc tính này cho các loại phần khác. Nếu loại là singlePlaylist , danh sách này phải chỉ định chính xác một mã nhận dạng danh sách phát. |
contentDetails.channels[] |
list Danh sách một hoặc nhiều mã nhận dạng kênh xuất hiện trong một phần kênh. Bạn phải chỉ định danh sách mã nhận dạng kênh nếu thuộc tính snippet.type của tài nguyên channelSection là multipleChannels và bạn không được chỉ định thuộc tính này cho các loại phần khác. Bạn không thể đưa kênh của mình vào danh sách. |