ChannelSections

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:

list
Trả về danh sách các tài nguyên channelSection khớp với tiêu chí yêu cầu API. Thử ngay.
chèn
Thêm một 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 một phần kênh. Thử ngay.
xóa
Xoá một phần kênh. Thử ngay.

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à:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
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.