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ã nhận dạng danh sách phát xác định video đã tải lên và video đã thích của 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 rằng 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 xây dựng thương hiệu của kênh

Ví dụ này cập nhật các lựa 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 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 rồi đặ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 xây dựng thương hiệu cho 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. Bạn có thể trích xuất mã nhận dạng từ phản hồi của API ở bước 1.
    • Đặt giá trị tham số part thành brandingSettings.

    Đường liên kết đến APIs Explorer bên dưới tạo một tài nguyên channel có 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 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 người dùng đã xác thực. Bạn cũng nên đặt các thuộc tính hình ảnh sao 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 của kênh. Phần kênh là một nhóm video được giới thiệu trên một 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 hay nhiều danh sách phát của kênh.

Ví dụ bên dưới truy xuất các phần trê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, tức là mã nhận dạng 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 cần được 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 rằng bạn đang truy xuất các phần kênh cho kênh của người dùng đã xác thực hiện tại.

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 mờ lên và đặt hình mờ đó 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 gian hiển thị.

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 tra truy vấn này bằng APIs Explorer vì APIs Explorer không hỗ trợ khả 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.