Channels

API hiện hỗ trợ tính năng đánh dấu kênh hoặc video là "dành cho trẻ em". Ngoài ra, các tài nguyên channelvideo hiện cũng chứa một thuộc tính xác định trạng thái "dành cho trẻ em" của kênh hoặc video đó. Chúng tôi cũng đã cập nhật Điều khoản dịch vụ và Chính sách dành cho nhà phát triển của Dịch vụ API YouTube vào ngày 10 tháng 1 năm 2020. Để biết thêm thông tin, hãy xem nhật ký sửa đổi của Dịch vụ YouTube Data APIĐiều khoản dịch vụ của Dịch vụ API YouTube.

Tài nguyên channel chứa thông tin về một kênh YouTube.

Phương thức

API này hỗ trợ các phương thức sau cho tài nguyên channels:

list
Trả về một tập hợp gồm 0 hoặc nhiều tài nguyên channel khớp với tiêu chí yêu cầu. Thử ngay.
update
Cập nhật siêu dữ liệu của một kênh. Xin lưu ý rằng phương thức này hiện chỉ hỗ trợ nội dung cập nhật cho các đối tượng brandingSettingsinvideoPromotion của tài nguyên channel cũng như các thuộc tính con của các đối tượng đó. Thử ngay.

Biểu thị tài nguyên

Cấu trúc JSON sau đây cho thấy định dạng của tài nguyên channels:

{
  "kind": "youtube#channel",
  "etag": etag,
  "id": string,
  "snippet": {
    "title": string,
    "description": string,
    "customUrl": string,
    "publishedAt": datetime,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "country": string
  },
  "contentDetails": {
    "relatedPlaylists": {
      "likes": string,
      "favorites": string,
      "uploads": string
    }
  },
  "statistics": {
    "viewCount": unsigned long,
    "subscriberCount": unsigned long,  // this value is rounded to three significant figures
    "hiddenSubscriberCount": boolean,
    "videoCount": unsigned long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "status": {
    "privacyStatus": string,
    "isLinked": boolean,
    "longUploadsStatus": string,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "brandingSettings": {
    "channel": {
      "title": string,
      "description": string,
      "keywords": string,
      "trackingAnalyticsAccountId": string,
      "unsubscribedTrailer": string,
      "defaultLanguage": string,
      "country": string
    },
    "watch": {
      "textColor": string,
      "backgroundColor": string,
      "featuredPlaylistId": string
    }
  },
  "auditDetails": {
    "overallGoodStanding": boolean,
    "communityGuidelinesGoodStanding": boolean,
    "copyrightStrikesGoodStanding": boolean,
    "contentIdClaimsGoodStanding": boolean
  },
  "contentOwnerDetails": {
    "contentOwner": string,
    "timeLinked": datetime
  },
  "localizations": {
    (key): {
      "title": string,
      "description": 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#channel.
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 kênh đó.
snippet object
Đối tượng snippet chứa các thông tin cơ bản về kênh, chẳng hạn như tiêu đề, nội dung mô tả và hình thu nhỏ.
snippet.title string
Tiêu đề của kênh.
snippet.description string
Nội dung mô tả của kênh. Giá trị của thuộc tính này có độ dài tối đa là 1000 ký tự.
snippet.customUrl string
URL tuỳ chỉnh của kênh. Trung tâm trợ giúp của YouTube giải thích các yêu cầu để có thể nhận URL tuỳ chỉnh cũng như cách thiết lập URL đó.
snippet.publishedAt datetime
Ngày và giờ tạo kênh. Giá trị được chỉ định ở định dạng ISO 8601.
snippet.thumbnails object
Bản đồ hình thu nhỏ liên kết với kênh. Đối với mỗi đối tượng trong bản đồ, khoá là tên của hình thu nhỏ và giá trị là một đối tượng chứa thông tin khác về hình thu nhỏ.

Khi hiển thị hình thu nhỏ trong ứng dụng, hãy đảm bảo rằng mã của bạn sử dụng URL hình ảnh chính xác như được trả về trong phản hồi API. Ví dụ: ứng dụng của bạn không được sử dụng miền http thay vì miền https trong URL được trả về trong phản hồi API.

URL hình thu nhỏ của kênh chỉ có trong miền https, đó là cách URL xuất hiện trong phản hồi API. Bạn có thể thấy hình ảnh bị hỏng trong ứng dụng nếu ứng dụng đó cố gắng tải hình ảnh YouTube từ miền http. Hình thu nhỏ có thể trống đối với các kênh mới tạo và có thể mất đến một ngày để điền hình thu nhỏ.
snippet.thumbnails.(key) object
Các giá trị khoá hợp lệ là:
  • default – Hình thu nhỏ mặc định. Hình thu nhỏ mặc định cho một video (hoặc tài nguyên tham chiếu đến một video, chẳng hạn như mục trong danh sách phát hoặc kết quả tìm kiếm) có chiều rộng 120 pixel và chiều cao 90 pixel. Hình thu nhỏ mặc định của kênh có chiều rộng 88 pixel và chiều cao 88 pixel.
  • medium – Phiên bản hình thu nhỏ có độ phân giải cao hơn. Đối với video (hoặc tài nguyên tham chiếu đến video), hình ảnh này có chiều rộng 320 px và chiều cao 180 px. Đối với kênh, hình ảnh này có chiều rộng 240 pixel và chiều cao 240 pixel.
  • high – Phiên bản hình thu nhỏ có độ phân giải cao. Đối với video (hoặc tài nguyên tham chiếu đến video), hình ảnh này có chiều rộng 480 pixel và chiều cao 360 pixel. Đối với kênh, hình ảnh này có chiều rộng 800 pixel và chiều cao 800 pixel.
snippet.thumbnails.(key).url string
URL của hình ảnh. Để biết thêm nguyên tắc về việc sử dụng URL hình thu nhỏ trong ứng dụng, hãy xem định nghĩa thuộc tính snippet.thumbnails.
snippet.thumbnails.(key).width unsigned integer
Chiều rộng của hình ảnh.
snippet.thumbnails.(key).height unsigned integer
Chiều cao của hình ảnh.
snippet.defaultLanguage string
Ngôn ngữ của văn bản trong thuộc tính snippet.titlesnippet.description của tài nguyên channel.
snippet.localized object
Đối tượng snippet.localized chứa tiêu đề và nội dung mô tả đã bản địa hoá cho kênh hoặc chứa tiêu đề và nội dung mô tả của kênh bằng ngôn ngữ mặc định cho siêu dữ liệu của kênh.
  • Văn bản được bản địa hoá sẽ được trả về trong đoạn mã tài nguyên nếu yêu cầu channels.list sử dụng tham số