ChannelSections

Tài nguyên channelSection chứa thông tin về một tập hợp video mà kênh đã chọn để giới thiệu. Ví dụ: Một phần có thể có các video tải lên mới nhất của kênh, các video tải lên phổ biến nhất hoặc cá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 pháp

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

list
Trả về danh sách tài nguyên channelSection phù hợp với tiêu chí của yêu cầu API. Thử ngay.
chèn
Thêm phần kênh vào kênh của người dùng đã xác thực. Một kênh có thể tạo tối đa 10 kệ. Thử ngay.
cập nhật
Cập nhật phần kênh. Thử ngay.
xóa
Xoá một phần của kênh. Thử ngay.

Biểu diễn tài nguyên

Cấu trúc JSON sau đây cho thấy đị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
Etag của tài nguyên này.
id string
Mã nhận dạng mà YouTube sử dụng để nhận dạng chính xác phần kênh.
snippet object
Đối tượng snippet chứa các thông tin cơ bản về phần kênh, chẳng hạn như loại và tiêu đề.
snippet.type string
Loại phần kênh.

Các giá trị hợp lệ cho tài sản này là:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
Mã nhận dạng mà YouTube sử dụng để nhận dạng duy nhất kênh đã xuất bản phần kênh đó.
snippet.title string
Tiêu đề của phần. 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, và 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, giá trị này sẽ bị bỏ qua.

Giá trị của thuộc tính 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 kênh trên trang kênh. Tài sản này sử dụng một chỉ mục dựa trên 0. Giá trị của 0 xác định phần đầu tiên xuất hiện trên kênh, giá trị 1 sẽ 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, hành vi mặc định là hiển thị phần mới ở cuối 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 phát hoặc các kênh có trong phần này.
contentDetails.playlists[] list
Danh sách một hoặc nhiều mã nhận dạng danh sách phát có trong phần kênh. Bạn phải chỉ định một danh sách mã nhận dạng 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, và không nên 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 ID danh sách phát.
contentDetails.channels[] list
Danh sách một hoặc nhiều mã nhận dạng kênh có trong phần kênh. Bạn phải chỉ định một 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à không nên 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 riêng mình vào danh sách.