Triển khai: Kênh

Trang này giải thích cách sử dụng YouTube Data API (phiên bản 3) để thực hiện các chức năng liên quan đến việc truy xuất và cập nhật dữ liệu kênh. Tài nguyên channel bao gồm mã danh sách phát giúp xác định video đã tải lên và video đã thích của một kênh. Để tìm nạp thông tin này khi gọi phương thức channels.list, hãy đảm bảo giá trị tham số part bao gồm phần tài nguyên contentDetails.

Truy xuất thông tin về một kênh

Gọi phương thức channels.list để truy xuất thông tin về một kênh cụ thể. Có một số cách để xác định kênh đó:

Thiết lập thông tin thương hiệu của kênh

Ví dụ này cập nhật các lựa chọn về bộ nhận diện thương hiệu của một kênh. Ví dụ này có hai bước:

  • Bước 1: Truy xuất các lựa chọn về thương hiệu của kênh

    Gọi phương thức channels.list và đặt giá trị tham số part thành brandingSettings và giá trị tham số mine thành true.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=brandingSettings
        &mine=true

    Ứng dụng của bạn có thể hiển thị các chế độ cài đặt đã truy xuất, cho phép người dùng sửa đổi các chế độ cài đặt để cập nhật.

  • Bước 2: Cập nhật các lựa chọn về thương hiệu của kênh

    Gọi phương thức channels.list và đặt các giá trị sau:

    • Đặt thuộc tính id thành mã nhận dạng kênh YouTube riêng biệt của kênh. Bạn có thể trích xuất mã nhận dạng từ phản hồi API ở bước 1.
    • Đặt giá trị tham số part thành brandingSettings.

    Đường liên kết đến Trình khám phá API bên dưới sẽ tạo một tài nguyên channel với các chế độ cài đặt thương hiệu sau:

    {
  "id": "CHANNEL_ID",
  "brandingSettings": {
    "channel": {
      "description": "A great channel to be enjoyed by all.",
      "moderateComments": true,
      "showRelatedChannels": true,
      "showBrowseView": true,
      "featuredChannelsTitle": "Featured Channel Stuff",
      "featuredChannelsUrls": [
        "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "UCBR8-60-B28hp2BmDPdntcQ",
        "UCK8sQmJBp8GCxrOtXWBpyEA"
      ],
      "profileColor": "#006600"
    }
  }
}

    Để hoàn tất yêu cầu trong Trình khám phá API, bạn cần đặt giá trị của thuộc tính id thành mã nhận dạng kênh của kênh của người dùng đã xác thực. Bạn cũng nên đặt các thuộc tính hình ảnh cho phù hợp với chế độ cài đặt hiện tại.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
        part=brandingSettings

Quản lý các phần trên kênh

API này hỗ trợ các phương thức channelSections.list, channelSections.insert, channelSections.update và channelSections.delete để quản lý các phần kênh. Phần kênh là một nhóm video xuất hiện nổi bật trên kênh. Ví dụ: một phần có thể bao gồm các video tải lên mới nhất, video tải lên phổ biến nhất hoặc video trong một hoặc nhiều danh sách phát của kênh.

Ví dụ bên dưới truy xuất các phần kênh cho kênh YouTube chính thức của Google. Yêu cầu này gọi phương thức channelSections.list và đặt giá trị tham số channelId thành UCK8sQmJBp8GCxrOtXWBpyEA, là mã kênh của kênh của Google. 

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA

Yêu cầu này yêu cầu uỷ quyền nếu thay vì sử dụng tham số channelId, bạn đặt giá trị tham số mine thành true. Thông số đó cho biết rằng bạn đang truy xuất các phần kênh cho kênh của người dùng hiện đã được xác thực.

Tải hình mờ lên và đặt hình mờ cho kênh

Bạn có thể gọi phương thức watermarks.set để tải hình ảnh hình mờ lên và đặt hình ảnh đó cho một kênh. Sau đó, hình ảnh này sẽ xuất hiện trong khi phát video của kênh được chỉ định. Bạn cũng có thể chỉ định một kênh mục tiêu mà hình ảnh sẽ liên kết đến, cũng như thông tin chi tiết về thời gian xác định thời điểm hình mờ xuất hiện và thời lượng hiển thị hình mờ.

Phương thức watermarks.unset xoá hình mờ của kênh.

Rất tiếc, bạn không thể kiểm thử truy vấn này bằng Trình khám phá API vì Trình khám phá API không hỗ trợ tính năng tải tệp phương tiện lên (đây là yêu cầu đối với phương thức này).