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
channel và video 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 và Đ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
channelkhớ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
brandingSettingsvàinvideoPromotioncủa tài nguyênchannelcũ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 |
stringXác định loại tài nguyên API. Giá trị sẽ là youtube#channel. |
etag |
etagEtag của tài nguyên này. |
id |
stringMã 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 |
stringTiêu đề của kênh. |
snippet.description |
stringNộ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 |
stringURL 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 |
datetimeNgày và giờ tạo kênh. Giá trị được chỉ định ở định dạng ISO 8601. |
snippet.thumbnails |
objectBả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) |
objectCác giá trị khoá hợp lệ là:
|
snippet.thumbnails.(key).url |
stringURL 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 integerChiều rộng của hình ảnh. |
snippet.thumbnails.(key).height |
unsigned integerChiều cao của hình ảnh. |
snippet.defaultLanguage |
stringNgôn ngữ của văn bản trong thuộc tính snippet.title và snippet.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.
|