ChannelSections

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

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 duy nhất phần kênh đó.
snippet object
Đối tượng snippet chứa 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 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 phần này. Bạn chỉ có thể đặt tiêu đề của 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ị đó 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 này trên trang kênh. Thuộc tính này sử dụng 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 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 phần kênh, thì chế độ mặc định sẽ 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 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 được trình bày nổi bật trong một phần kênh. Bạn phải chỉ định một 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, đồng thời 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 nổi bật trong một 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, đồng thời 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ể thêm kênh của mình vào danh sách này.