Triển khai: Kênh

Trang này giải thích cách sử dụng API dữ liệu YouTube (v3) để 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 của kênh. Tài nguyên channel bao gồm mã nhận dạng danh sách phát giúp xác định các video đã tải lên và được 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 có chứa phần tài nguyên contentDetails.

Truy xuất thông tin về 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 tùy chọn xây dựng thương hiệu của kênh. Ví dụ này có 2 bước:

  • Bước 1: Truy xuất tuỳ chọn xây dựng thương hiệu của kênh

    Gọi phương thức channels.list và đặt giá trị thông số part thành brandingSettings, còn giá trị thông 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ị chế độ cài đặt đã truy xuất, cho phép người dùng sửa đổi chế độ cài đặt để cập nhật.

  • Bước 2: Cập nhật các lựa chọn xây dựng 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 duy nhất của kênh. Mã nhận dạng này có thể được trích xuất từ phản hồi API ở bước 1.
    • Đặt giá trị tham số part thành brandingSettings.

    Đường liên kết đến API Explorer bên dưới sẽ tạo một tài nguyên channel với các chế độ cài đặt xây dựng 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 APIs Explorer, 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 người dùng đã xác thực. Bạn cũng nên đặt 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 của kênh

API này hỗ trợ các phương thức channelSection.list, channelSection.insert, channelSection.update và channelSection.delete để quản lý các phần kênh. Phần kênh là tập hợp 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 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.

Ví dụ dưới đây truy xuất 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ị thông số channelId thành UCK8sQmJBp8GCxrOtXWBpyEA, đây là mã nhận dạng kênh cho 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 bạn đặt giá trị tham số mine thành true thay vì sử dụng tham số channelId. Tham số đó cho biết 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 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 lên hình mờ và đặt hình ảnh đó cho một kênh. Sau đó, hình ảnh sẽ hiển thị trong khi phát lại 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 gian hiển thị hình mờ.

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

Rất tiếc, không thể kiểm tra truy vấn này bằng APIs Explorer bởi vì APIs Explorer không hỗ trợ khả năng tải các tệp phương tiện lên, đây là yêu cầu đối với phương pháp này.