Tài nguyên video đại diện cho một video trên YouTube.
Phương thức
API này hỗ trợ các phương thức sau cho tài nguyên videos:
- getRating
- Lấy thông tin về điểm xếp hạng mà người dùng được uỷ quyền đã đưa ra cho một danh sách video cụ thể. Thử ngay.
- list
- Trả về danh sách video khớp với các tham số của yêu cầu API. Thử ngay.
- batchGetStats
- Lấy danh sách số liệu thống kê về video khớp với các tham số của yêu cầu API. Thử ngay.
- insert
- Tải video lên YouTube và đặt siêu dữ liệu của video (không bắt buộc).
- update
- Cập nhật siêu dữ liệu của video. Thử ngay.
- xóa
- Xoá một video trên YouTube. Thử ngay.
- rate
- Thêm lượt thích hoặc không thích cho một video hoặc xoá lượt thích/không thích khỏi một video. Thử ngay.
- reportAbuse
- Báo cáo video có nội dung vi phạm. Thử ngay.
Cách trình bày tài nguyên
Cấu trúc JSON sau đây cho thấy định dạng của tài nguyên videos:
{
"kind": "youtube#video",
"etag": etag,
"id": string,
"snippet": {
"publishedAt": datetime,
"channelId": string,
"title": string,
"description": string,
"thumbnails": {
(key): {
"url": string,
"width": unsigned integer,
"height": unsigned integer
}
},
"channelTitle": string,
"tags": [
string
],
"categoryId": string,
"liveBroadcastContent": string,
"defaultLanguage": string,
"localized": {
"title": string,
"description": string
},
"defaultAudioLanguage": string
},
"contentDetails": {
"duration": string,
"dimension": string,
"definition": string,
"caption": string,
"licensedContent": boolean,
"regionRestriction": {
"allowed": [
string
],
"blocked": [
string
]
},
"contentRating": {
"acbRating": string,
"agcomRating": string,
"anatelRating": string,
"bbfcRating": string,
"bfvcRating": string,
"bmukkRating": string,
"catvRating": string,
"catvfrRating": string,
"cbfcRating": string,
"cccRating": string,
"cceRating": string,
"chfilmRating": string,
"chvrsRating": string,
"cicfRating": string,
"cnaRating": string,
"cncRating": string,
"csaRating": string,
"cscfRating": string,
"czfilmRating": string,
"djctqRating": string,
"djctqRatingReasons": [,
string
],
"ecbmctRating": string,
"eefilmRating": string,
"egfilmRating": string,
"eirinRating": string,
"fcbmRating": string,
"fcoRating": string,
"fmocRating": string,
"fpbRating": string,
"fpbRatingReasons": [,
string
],
"fskRating": string,
"grfilmRating": string,
"icaaRating": string,
"ifcoRating": string,
"ilfilmRating": string,
"incaaRating": string,
"kfcbRating": string,
"kijkwijzerRating": string,
"kmrbRating": string,
"lsfRating": string,
"mccaaRating": string,
"mccypRating": string,
"mcstRating": string,
"mdaRating": string,
"medietilsynetRating": string,
"mekuRating": string,
"mibacRating": string,
"mocRating": string,
"moctwRating": string,
"mpaaRating": string,
"mpaatRating": string,
"mtrcbRating": string,
"nbcRating": string,
"nbcplRating": string,
"nfrcRating": string,
"nfvcbRating": string,
"nkclvRating": string,
"oflcRating": string,
"pefilmRating": string,
"rcnofRating": string,
"resorteviolenciaRating": string,
"rtcRating": string,
"rteRating": string,
"russiaRating": string,
"skfilmRating": string,
"smaisRating": string,
"smsaRating": string,
"tvpgRating": string,
"ytRating": string
},
"projection": string,
"hasCustomThumbnail": boolean
},
"status": {
"uploadStatus": string,
"failureReason": string,
"rejectionReason": string,
"privacyStatus": string,
"publishAt": datetime,
"license": string,
"embeddable": boolean,
"publicStatsViewable": boolean,
"madeForKids": boolean,
"selfDeclaredMadeForKids": boolean,
"containsSyntheticMedia": boolean
},
"statistics": {
"viewCount": string,
"likeCount": string,
"dislikeCount": string,
"favoriteCount": string,
"commentCount": string
},
"paidProductPlacementDetails": {
"hasPaidProductPlacement": boolean
},
"player": {
"embedHtml": string,
"embedHeight": long,
"embedWidth": long
},
"topicDetails": {
"topicIds": [
string
],
"relevantTopicIds": [
string
],
"topicCategories": [
string
]
},
"recordingDetails": {
"recordingDate": datetime
},
"fileDetails": {
"fileName": string,
"fileSize": unsigned long,
"fileType": string,
"container": string,
"videoStreams": [
{
"widthPixels": unsigned integer,
"heightPixels": unsigned integer,
"frameRateFps": double,
"aspectRatio": double,
"codec": string,
"bitrateBps": unsigned long,
"rotation": string,
"vendor": string
}
],
"audioStreams": [
{
"channelCount": unsigned integer,
"codec": string,
"bitrateBps": unsigned long,
"vendor": string
}
],
"durationMs": unsigned long,
"bitrateBps": unsigned long,
"creationTime": string
},
"processingDetails": {
"processingStatus": string,
"processingProgress": {
"partsTotal": unsigned long,
"partsProcessed": unsigned long,
"timeLeftMs": unsigned long
},
"processingFailureReason": string,
"fileDetailsAvailability": string,
"processingIssuesAvailability": string,
"tagSuggestionsAvailability": string,
"editorSuggestionsAvailability": string,
"thumbnailsAvailability": string
},
"suggestions": {
"processingErrors": [
string
],
"processingWarnings": [
string
],
"processingHints": [
string
],
"tagSuggestions": [
{
"tag": string,
"categoryRestricts": [
string
]
}
],
"editorSuggestions": [
string
]
},
"liveStreamingDetails": {
"actualStartTime": datetime,
"actualEndTime": datetime,
"scheduledStartTime": datetime,
"scheduledEndTime": datetime,
"concurrentViewers": unsigned long,
"activeLiveChatId": string
},
"brandPartner": {
"channelId": string,
"channelHandle": string
},
"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#video. |
etag |
etagEtag của tài nguyên này. |
id |
stringMã nhận dạng mà YouTube dùng để xác định riêng biệt video. |
snippet |
objectĐối tượng snippet chứa thông tin chi tiết cơ bản về video, chẳng hạn như tiêu đề, nội dung mô tả và danh mục. |
snippet.publishedAt |
datetimeNgày và giờ xuất bản video. Thời gian này có thể khác với thời gian video được tải lên. Ví dụ: nếu một video được tải lên ở chế độ riêng tư rồi sau đó được chuyển sang chế độ công khai, thì thuộc tính này sẽ chỉ định thời điểm video được chuyển sang chế độ công khai. Có một số trường hợp đặc biệt:
|
snippet.channelId |
stringMã nhận dạng mà YouTube dùng để xác định riêng biệt kênh đã tải video lên. Giá trị này có thể thay đổi theo thời gian, chẳng hạn như khi một video được chỉ định lại cho một kênh khác (ví dụ: kênh chủ đề hoặc kênh nghệ sĩ). |
snippet.title |
stringTiêu đề của video. Giá trị thuộc tính có độ dài tối đa là 100 ký tự và có thể chứa tất cả các ký tự UTF-8 hợp lệ ngoại trừ < và >. Bạn phải đặt giá trị cho thuộc tính này nếu gọi phương thức videos.update và đang cập nhật phần snippet của tài nguyên video. |
snippet.description |
stringNội dung mô tả video. Giá trị thuộc tính có độ dài tối đa là 5.000 byte và có thể chứa tất cả các ký tự UTF-8 hợp lệ, ngoại trừ < và >. Bạn có thể tạo phân cảnh video bằng cách thêm dấu thời gian được định dạng (ví dụ: 00:00) vào văn bản mô tả. |
snippet.thumbnails |
objectSơ đồ trang web chứa hình thu nhỏ liên kết với video. Đố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ỏ. |
snippet.thumbnails.(key) |
objectCác giá trị khoá hợp lệ là:
|
snippet.thumbnails.(key).url |
stringURL của hình ảnh. |
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.channelTitle |
stringTiêu đề của kênh chứa video. |
snippet.tags[] |
listDanh sách các thẻ từ khoá liên kết với video. Thẻ có thể chứa dấu cách. Giá trị thuộc tính có độ dài tối đa là 500 ký tự. Hãy lưu ý những quy tắc sau đây về cách tính giới hạn ký tự:
|
snippet.categoryId |
stringDanh mục video trên YouTube liên kết với video. Bạn phải đặt giá trị cho thuộc tính này nếu gọi phương thức videos.update và đang cập nhật phần snippet của tài nguyên video. |
snippet.liveBroadcastContent |
stringCho biết video có phải là một sự kiện phát sóng trực tiếp sắp diễn ra/đang diễn ra hay không. Giá trị của thuộc tính này là Các giá trị hợp lệ cho thuộc tính này là:
|
snippet.defaultLanguage |
stringNgôn ngữ của văn bản trong các thuộc tính snippet.title và snippet.description của tài nguyên video. |
snippet.localized |
objectĐối tượng snippet.localized chứa tiêu đề và nội dung mô tả đã bản địa hoá cho video hoặc tiêu đề bằng ngôn ngữ mặc định cho siêu dữ liệu của video.
localizations để thêm, cập nhật hoặc xoá tiêu đề đã bản địa hoá. |
snippet.localized.title |
stringTiêu đề video đã bản địa hoá. |
snippet.localized.description |
stringNội dung mô tả video đã bản địa hoá. |
snippet.defaultAudioLanguage |
stringThuộc tính default_audio_language chỉ định ngôn ngữ được nói trong bản âm thanh mặc định của video. |
contentDetails |
objectĐối tượng contentDetails chứa thông tin về nội dung video, bao gồm cả thời lượng video và chỉ báo về việc video có phụ đề hay không. |
contentDetails.duration |
stringThời lượng video. Giá trị thuộc tính là thời lượng theo ISO 8601. Ví dụ: đối với video dài ít nhất một phút và dưới một giờ, thời lượng sẽ có định dạng PT#M#S, trong đó các chữ cái PT cho biết giá trị chỉ định một khoảng thời gian, còn các chữ cái M và S lần lượt là thời lượng tính bằng phút và giây. Các ký tự # đứng trước chữ cái M và S đều là số nguyên chỉ định số phút (hoặc giây) của video. Ví dụ: giá trị PT15M33S cho biết video dài 15 phút 33 giây.Nếu video dài ít nhất một giờ, thì thời lượng sẽ có định dạng PT#H#M#S, trong đó # đứng trước chữ cái H chỉ định thời lượng của video tính bằng giờ và tất cả các thông tin chi tiết khác đều giống như mô tả ở trên. Nếu video dài ít nhất một ngày, thì các chữ cái P và T sẽ được phân tách và định dạng của giá trị là P#DT#H#M#S. Vui lòng tham khảo quy cách ISO 8601 để biết thông tin chi tiết đầy đủ. |
contentDetails.dimension |
stringCho biết video có ở định dạng 3D hay 2D. |
contentDetails.definition |
stringCho biết video có ở độ nét cao ( HD) hay chỉ ở độ nét chuẩn.Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.caption |
stringCho biết video có phụ đề hay không. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.licensedContent |
booleanCho biết video có phải là nội dung được cấp phép hay không, tức là nội dung được tải lên một kênh liên kết với một đối tác nội dung của YouTube và sau đó được đối tác đó xác nhận quyền sở hữu. |
contentDetails.regionRestriction |
objectĐối tượng regionRestriction chứa thông tin về những quốc gia nơi người dùng có thể (hoặc không thể) xem video. Đối tượng sẽ chứa thuộc tính contentDetails.regionRestriction.allowed hoặc thuộc tính contentDetails.regionRestriction.blocked. |
contentDetails.regionRestriction.allowed[] |
listDanh sách mã khu vực xác định các quốc gia nơi người dùng có thể xem video. Nếu thuộc tính này xuất hiện và một quốc gia không có trong giá trị của thuộc tính, thì video sẽ bị chặn xuất hiện ở quốc gia đó. Nếu thuộc tính này có trong video và chứa danh sách trống, thì video đó sẽ bị chặn ở tất cả các quốc gia. |
contentDetails.regionRestriction.blocked[] |
listDanh sách mã khu vực xác định các quốc gia nơi video bị chặn. Nếu thuộc tính này xuất hiện và một quốc gia không có trong giá trị của thuộc tính, thì video có thể xem được ở quốc gia đó. Nếu thuộc tính này có trong video và chứa một danh sách trống, thì video đó có thể xem được ở mọi quốc gia. |
contentDetails.contentRating |
objectChỉ định điểm xếp hạng mà video nhận được theo nhiều hệ thống xếp hạng. |
contentDetails.contentRating.acbRating |
stringMức phân loại của video theo Uỷ ban phân loại Úc (ACB) hoặc Cơ quan Thông tin và Truyền thông Úc (ACMA). Hệ thống phân loại của ACMA được dùng để phân loại chương trình truyền hình dành cho trẻ em. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.agcomRating |
stringMức phân loại của video do Autorità per le Garanzie nelle Comunicazioni (AGCOM) của Ý đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.anatelRating |
stringMức phân loại của video theo Anatel (Asociación Nacional de Televisión) cho truyền hình Chile. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.bbfcRating |
stringMức phân loại của video theo Hội đồng phân loại phim của Anh (BBFC). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.bfvcRating |
stringMức phân loại của video do Hội đồng kiểm duyệt phim và video của Thái Lan đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.bmukkRating |
stringMức phân loại của video do Uỷ ban phân loại nội dung nghe nhìn của Áo (Bundesministerium für Unterricht, Kunst und Kultur) đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.catvRating |
stringHệ thống phân loại dành cho chương trình truyền hình Canada – Hệ thống phân loại chương trình truyền hình Canada Mức phân loại của video do Uỷ ban Viễn thông và Phát thanh Truyền hình Canada (CRTC) đưa ra cho các chương trình phát sóng bằng tiếng Anh ở Canada. Để biết thêm thông tin, hãy xem trang web của Hội đồng tiêu chuẩn phát sóng Canada. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.catvfrRating |
stringMức phân loại của video do Uỷ ban Viễn thông và Phát thanh Truyền hình Canada (CRTC) đưa ra cho các chương trình phát sóng bằng tiếng Pháp ở Canada. Để biết thêm thông tin, hãy xem trang web của Hội đồng tiêu chuẩn phát sóng Canada. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.cbfcRating |
stringMức phân loại của video theo Central Board of Film Certification (CBFC – Ấn Độ). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.cccRating |
stringMức phân loại của video theo Consejo de Calificación Cinematográfica (Chile). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.cceRating |
stringMức phân loại của video theo Comissão de Classificação de Espect´culos của Bồ Đào Nha. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.chfilmRating |
stringMức phân loại của video ở Thuỵ Sĩ. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.chvrsRating |
stringMức phân loại của video theo Hệ thống phân loại video gia đình của Canada (CHVRS). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.cicfRating |
stringMức phân loại của video do Commission de Contrôle des Films (Bỉ) đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.cnaRating |
stringMức phân loại của video theo CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) của Romania. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.cncRating |
stringHệ thống phân loại ở Pháp – Commission de classification cinematographique Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.csaRating |
stringMức phân loại của video theo Conseil supérieur de l'audiovisuel của Pháp, cơ quan phân loại nội dung phát sóng. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.cscfRating |
stringMức phân loại của video do Commission de surveillance de la classification des films (CSCF) của Luxembourg đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.czfilmRating |
stringMức phân loại của video tại Cộng hoà Séc. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.djctqRating |
stringMức phân loại của video theo Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT – Brazil). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.djctqRatingReasons[] |
listLý do giải thích tại sao video nhận được mức phân loại của DJCQT (Brazil). |
contentDetails.contentRating.ecbmctRating |
stringHệ thống phân loại ở Thổ Nhĩ Kỳ – Hội đồng đánh giá và phân loại của Bộ Văn hoá và Du lịch Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.eefilmRating |
stringMức phân loại của video ở Estonia. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.egfilmRating |
stringMức phân loại của video ở Ai Cập. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.eirinRating |
stringMức phân loại của Eirin (映倫) cho video. Eirin là hệ thống phân loại của Nhật Bản. Thuộc tính này có thể có các giá trị sau:
|
contentDetails.contentRating.fcbmRating |
stringMức phân loại của video do Hội đồng kiểm duyệt phim Malaysia cấp. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.fcoRating |
stringMức phân loại của video do Văn phòng quản lý phim, báo và bài viết của Hong Kong cấp. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.fmocRating |
stringThuộc tính này không còn được dùng nữa kể từ ngày 2 tháng 11 năm 2015. Thay vào đó, hãy sử dụng thuộc tính contentDetails.contentRating.cncRating.Mức phân loại của video theo Centre national du cinéma et de l'image animé (Bộ Văn hoá Pháp). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.fpbRating |
stringMức phân loại của video do Hội đồng Xuất bản và Điện ảnh Nam Phi đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.fpbRatingReasons[] |
listLý do giải thích tại sao video nhận được mức phân loại của FPB (Nam Phi). |
contentDetails.contentRating.fskRating |
stringMức phân loại của Freiwillige Selbstkontrolle der Filmwirtschaft (FSK – Đức) cho video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.grfilmRating |
stringMức phân loại của video ở Hy Lạp. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.icaaRating |
stringMức phân loại của Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Tây Ban Nha) cho video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.ifcoRating |
stringMức phân loại của video theo Văn phòng phân loại phim Ireland (IFCO – Ireland). Hãy xem trang web của IFCO để biết thêm thông tin. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.ilfilmRating |
stringMức phân loại của video ở Israel. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.incaaRating |
stringMức phân loại của video theo INCAA (Instituto Nacional de Cine y Artes Audiovisuales – Argentina). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.kfcbRating |
stringMức phân loại của video do Uỷ ban phân loại phim Kenya đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.kijkwijzerRating |
stringvoor de Classificatie van Audiovisuele Media (Hà Lan). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.kmrbRating |
stringMức phân loại của video theo Hội đồng xếp hạng truyền thông Hàn Quốc (영상물등급위원회). KMRB phân loại video ở Hàn Quốc. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.lsfRating |
stringMức phân loại của video theo Lembaga Sensor Film của Indonesia. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mccaaRating |
stringMức phân loại của video do Hội đồng phân loại độ tuổi phim của Malta đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mccypRating |
stringMức phân loại của video do Hội đồng truyền thông dành cho trẻ em và thanh thiếu niên của Viện phim Đan Mạch (Det Danske Filminstitut) đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mcstRating |
stringHệ thống phân loại video của Bộ Văn hoá, Thể thao và Du lịch Việt Nam Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mdaRating |
stringMức phân loại của video do Cơ quan Phát triển Truyền thông (MDA) của Singapore và cụ thể là Hội đồng Kiểm duyệt Phim (BFC) của cơ quan này đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.medietilsynetRating |
stringMức phân loại của video theo Medietilsynet, Cơ quan Truyền thông Na Uy. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mekuRating |
stringMức phân loại của video do Kansallinen Audiovisuaalinen Instituutti (Viện Nghe nhìn Quốc gia) của Phần Lan đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mibacRating |
stringMức phân loại của video do Bộ Di sản, Hoạt động Văn hoá và Du lịch (Ý) đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mocRating |
stringMức phân loại của video theo Ministerio de Cultura (Colombia). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.moctwRating |
stringMức phân loại của video do Bộ Văn hoá Đài Loan (文化部) đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mpaaRating |
stringMức phân loại của Hiệp hội Điện ảnh Hoa Kỳ (MPAA) cho video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mpaatRating |
stringMức phân loại của Hiệp hội Điện ảnh Hoa Kỳ cho đoạn giới thiệu và bản xem trước phim. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mtrcbRating |
stringMức phân loại của video do Hội đồng phân loại và đánh giá phim và truyền hình (Philippines) đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.nbcRating |
stringMức phân loại của video do Cục Phân loại Quốc gia Maldives cấp. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.nfrcRating |
stringMức phân loại của video do Bulgarian National Film Center (Trung tâm Điện ảnh Quốc gia Bulgaria) đưa ra. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.nfvcbRating |
stringMức phân loại của video do National Film and Video Censors Board của Nigeria cấp. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.nkclvRating |
stringMức phân loại của video do Nacionãlais Kino centrs (Trung tâm Điện ảnh Quốc gia Latvia) cấp. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.oflcRating |
stringMức phân loại của video theo Văn phòng phân loại phim và văn học (OFLC – New Zealand). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.pefilmRating |
stringMức phân loại của video ở Peru. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.resorteviolenciaRating |
stringMức phân loại của video ở Venezuela. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.rtcRating |
stringMức phân loại của video theo Tổng cục Phát thanh, Truyền hình và Điện ảnh (Mexico). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.rteRating |
stringMức phân loại của video theo Raidió Teilifís Éireann của Ireland. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.russiaRating |
stringMức phân loại của video theo Cơ quan đăng ký phim quốc gia của Liên bang Nga (MKRF – Nga). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.skfilmRating |
stringMức phân loại của video ở Slovakia. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.smaisRating |
stringMức phân loại của video ở Iceland. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.smsaRating |
stringMức phân loại của video theo Statens medieråd (Hội đồng Truyền thông Quốc gia Thuỵ Điển). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.tvpgRating |
stringMức phân loại của video theo Hướng dẫn dành cho cha mẹ về chương trình truyền hình (TVPG). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.ytRating |
stringMức phân loại mà YouTube dùng để xác định nội dung bị giới hạn độ tuổi. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.projection |
stringChỉ định định dạng chiếu của video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.hasCustomThumbnail |
booleanCho biết liệu người tải video lên có cung cấp hình thu nhỏ tùy chỉnh cho video hay không. Chỉ người tải video lên mới thấy thuộc tính này. |
status |
objectĐối tượng status chứa thông tin về trạng thái tải lên, xử lý và quyền riêng tư của video. |
status.uploadStatus |
stringTrạng thái của video đã tải lên. Thuộc tính này có thể có các giá trị sau:
|
status.failureReason |
stringGiá trị này giải thích lý do không tải được video lên. Thuộc tính này chỉ xuất hiện nếu thuộc tính uploadStatus cho biết quá trình tải lên không thành công.Các giá trị hợp lệ cho thuộc tính này là:
|
status.rejectionReason |
stringGiá trị này giải thích lý do YouTube từ chối một video đã tải lên. Thuộc tính này chỉ xuất hiện nếu thuộc tính uploadStatus cho biết rằng tệp tải lên đã bị từ chối.Các giá trị hợp lệ cho thuộc tính này là:
|
status.privacyStatus |
stringTrạng thái quyền riêng tư của video. Trong yêu cầu videos.insert, nếu bạn không chỉ định giá trị cho thuộc tính này, thì trạng thái quyền riêng tư của video đã tải lên sẽ được đặt mặc định là public. Một số video tải lên có thể được đặt mặc định là private dựa trên chế độ cài đặt tài khoản của nhà sáng tạo, như giải thích trong Trung tâm trợ giúp của YouTube. Video được tải lên từ các dự án API chưa được xác minh không bị hạn chế ở chế độ xem riêng tư.Các giá trị hợp lệ cho thuộc tính này là:
|
status.publishAt |
datetimeNgày và giờ mà video được lên lịch xuất bản. Bạn chỉ có thể đặt thuộc tính này nếu trạng thái quyền riêng tư của video là riêng tư. Giá trị được chỉ định ở định dạng ISO 8601. Lưu ý hai điểm bổ sung sau đây về hành vi của thuộc tính này:
|
status.license |
stringGiấy phép của video. Các giá trị hợp lệ cho thuộc tính này là:
|
status.embeddable |
booleanGiá trị này cho biết liệu video có thể được nhúng trên một trang web khác hay không. |
status.publicStatsViewable |
booleanGiá trị này cho biết liệu số liệu thống kê mở rộng về video trên trang xem của video có được hiển thị công khai hay không. Theo mặc định, những số liệu thống kê đó có thể xem được và các số liệu thống kê như số lượt xem và điểm xếp hạng của video vẫn sẽ hiển thị công khai ngay cả khi giá trị của thuộc tính này được đặt thành false. |
status.madeForKids |
booleanGiá trị này cho biết liệu video có được chỉ định là dành cho trẻ em hay không và chứa trạng thái "dành cho trẻ em" hiện tại của video. Ví dụ: trạng thái có thể được xác định dựa trên giá trị của thuộc tính selfDeclaredMadeForKids. Hãy xem
Trung tâm trợ giúp của YouTube để biết thêm
thông tin về cách đặt đối tượng người xem cho kênh, video hoặc chương trình phát sóng của bạn.
|
status.selfDeclaredMadeForKids |
booleanTrong yêu cầu videos.insert hoặc videos.update, thuộc tính này cho phép chủ sở hữu kênh chỉ định video là dành cho trẻ em. Trong yêu cầu videos.list, giá trị thuộc tính chỉ được trả về nếu chủ sở hữu kênh cho phép yêu cầu API. |
status.containsSyntheticMedia |
booleanTrong yêu cầu videos.insert hoặc videos.update, thuộc tính này cho phép chủ sở hữu kênh công bố rằng video có chứa Nội dung đã được chỉnh sửa hoặc nội dung nhân tạo (A/S) trông như thật. Tìm hiểu thêm về
các chính sách của YouTube
liên quan đến nội dung về hành vi tự huỷ hoại bản thân.Ví dụ về nội dung A/S bao gồm những video:
|
statistics |
objectĐối tượng statistics chứa số liệu thống kê về video. |
statistics.viewCount |
unsigned longSố lượt xem video. Đối với tất cả định dạng video (video dài, sự kiện phát trực tiếp và video Shorts), Đối với mọi định dạng video (video dài, sự kiện phát trực tiếp và video Shorts), |
statistics.likeCount |
unsigned longSố người dùng cho biết rằng họ thích video. |
statistics.dislikeCount |
unsigned longLưu ý: Thuộc tính
statistics.dislikeCount được đặt ở chế độ riêng tư kể từ ngày 13 tháng 12 năm 2021. Điều này có nghĩa là tài sản chỉ được đưa vào phản hồi của API nếu yêu cầu API được chủ sở hữu video xác thực. Hãy xem nhật ký sửa đổi để biết thêm thông tin.Số người dùng cho biết rằng họ không thích video. |
statistics.favoriteCount |
unsigned longLưu ý: Thuộc tính này không còn được dùng nữa. Việc ngừng sử dụng này có hiệu lực từ ngày 28 tháng 8 năm 2015. Giá trị của thuộc tính này hiện luôn được đặt thành 0. |
statistics.commentCount |
unsigned longSố lượng bình luận về video. |
paidProductPlacementDetails |
objectĐối tượng paidProductPlacementDetails chứa thông tin về nội dung được trả tiền để lồng ghép sản phẩm trong video. |
paidProductPlacementDetails.hasPaidProductPlacement |
booleanĐặt thành true nếu nội dung có nội dung được trả tiền để lồng ghép sản phẩm. Đặt thành false nếu nội dung không sử dụng nội dung được trả tiền để lồng ghép sản phẩm. |
player |
objectĐối tượng player chứa thông tin mà bạn sẽ dùng để phát video trong trình phát được nhúng. |
player.embedHtml |
stringThẻ <iframe> nhúng một trình phát để phát video.
|
player.embedHeight |
longChiều cao của trình phát được nhúng được trả về trong thuộc tính player.embedHtml. Thuộc tính này chỉ được trả về nếu yêu cầu chỉ định một giá trị cho tham số maxHeight và/hoặc maxWidth và tỷ lệ khung hình của video đã được xác định. |
player.embedWidth |
longChiều rộng của trình phát được nhúng, được trả về trong thuộc tính player.embedHtml. Thuộc tính này chỉ được trả về nếu yêu cầu chỉ định một giá trị cho tham số maxHeight và/hoặc maxWidth và tỷ lệ khung hình của video đã được xác định. |
topicDetails |
objectĐối tượng topicDetails đóng gói thông tin về các chủ đề liên quan đến video.Quan trọng: Hãy xem định nghĩa về các thuộc tính topicDetails.relevantTopicIds[] và topicDetails.topicIds[] cũng như nhật ký sửa đổi để biết thêm thông tin chi tiết về những thay đổi sắp tới liên quan đến mã chủ đề. |
topicDetails.topicIds[] |
listQuan trọng: Thuộc tính này không còn được dùng nữa kể từ ngày 10 tháng 11 năm 2016. API này không còn trả về giá trị cho thuộc tính này nữa và mọi chủ đề liên quan đến video hiện được trả về theo giá trị thuộc tính topicDetails.relevantTopicIds[]. |
topicDetails.relevantTopicIds[] |
listDanh sách mã chủ đề có liên quan đến video. Thuộc tính này không còn được dùng kể từ ngày 10 tháng 11 năm 2016. API này sẽ được hỗ trợ đến ngày 10 tháng 11 năm 2017. Quan trọng: Do Freebase và API Freebase không còn được dùng nữa, nên mã chủ đề bắt đầu hoạt động theo cách khác kể từ ngày 27 tháng 2 năm 2017. Vào thời điểm đó, YouTube bắt đầu trả về một nhóm nhỏ mã chủ đề được tuyển chọn. |
topicDetails.topicCategories[] |
listDanh sách URL Wikipedia cung cấp thông tin mô tả cấp cao về nội dung của video. |
recordingDetails |
objectĐối tượng recordingDetails đóng gói thông tin về vị trí, ngày và địa chỉ nơi video được quay. |
recordingDetails.locationDescription |
stringThuộc tính này không được dùng nữa kể từ ngày 1 tháng 6 năm 2017. Vui lòng xem thông báo về việc ngừng sử dụng để biết thêm thông tin chi tiết. Nội dung mô tả bằng văn bản về địa điểm quay video. |
recordingDetails.location |
objectThuộc tính này không được dùng nữa. Tất cả các thuộc tính con (vĩ độ, kinh độ, cao độ) đều không được dùng nữa. Thông tin vị trí địa lý liên kết với video. Giá trị của thuộc tính con xác định vị trí mà chủ sở hữu video muốn liên kết với video. Bạn có thể chỉnh sửa giá trị này, tìm kiếm giá trị này trên các video công khai và người dùng có thể thấy giá trị này trên các video công khai. |
recordingDetails.location.latitude |
doubleThuộc tính này không được dùng nữa kể từ ngày 1 tháng 6 năm 2017. Vui lòng xem thông báo về việc ngừng sử dụng để biết thêm thông tin chi tiết. Vĩ độ tính bằng độ. |
recordingDetails.location.longitude |
doubleThuộc tính này không được dùng nữa kể từ ngày 1 tháng 6 năm 2017. Vui lòng xem thông báo về việc ngừng sử dụng để biết thêm thông tin chi tiết. Kinh độ theo độ. |
recordingDetails.location.altitude |
doubleThuộc tính này không còn được dùng nữa kể từ ngày 9 tháng 7 năm 2018. Vui lòng xem thông báo về việc ngừng sử dụng để biết thêm thông tin chi tiết. Độ cao so với ellipsoid tham chiếu, tính bằng mét. |
recordingDetails.recordingDate |
datetimeNgày và giờ quay video. Giá trị được chỉ định ở định dạng ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ). |
fileDetails |
objectĐối tượng fileDetails đóng gói thông tin về tệp video đã tải lên YouTube, bao gồm độ phân giải, thời lượng, bộ mã hoá và giải mã âm thanh và video, tốc độ bit của luồng và nhiều thông tin khác. Chỉ chủ sở hữu video mới có thể truy xuất dữ liệu này.Đối tượng fileDetails sẽ chỉ được trả về nếu thuộc tính processingDetails.fileAvailability có giá trị là available. |
fileDetails.fileName |
stringTên của tệp đã tải lên. Trường này xuất hiện cho dù bạn tải tệp video hay một loại tệp khác lên. |
fileDetails.fileSize |
unsigned longKích thước của tệp đã tải lên, tính bằng byte. Trường này xuất hiện cho dù bạn tải tệp video hay một loại tệp khác lên. |
fileDetails.fileType |
stringLoại tệp đã tải lên do công cụ xử lý video của YouTube phát hiện. Hiện tại, YouTube chỉ xử lý các tệp video, nhưng trường này sẽ xuất hiện cho dù tệp video hay một loại tệp khác được tải lên. Các giá trị hợp lệ cho thuộc tính này là:
|
fileDetails.container |
stringĐịnh dạng vùng chứa của tệp video đã tải lên. |
fileDetails.videoStreams[] |
listDanh sách các luồng video có trong tệp video đã tải lên. Mỗi mục trong danh sách chứa siêu dữ liệu chi tiết về một luồng video. |
fileDetails.videoStreams[].widthPixels |
unsigned integerChiều rộng của nội dung video được mã hoá, tính bằng pixel. Bạn có thể tính tỷ lệ khung hình mã hoá của video bằng cách lấy width_pixels / height_pixels. |
fileDetails.videoStreams[].heightPixels |
unsigned integerChiều cao của nội dung video được mã hoá, tính bằng pixel. |
fileDetails.videoStreams[].frameRateFps |
doubleTốc độ khung hình của luồng video, tính bằng số khung hình/giây. |
fileDetails.videoStreams[].aspectRatio |
doubleTỷ lệ khung hình hiển thị của nội dung video, chỉ định tỷ lệ khung hình mà video sẽ hiển thị. |
fileDetails.videoStreams[].codec |
stringBộ mã hoá và giải mã video mà sự kiện phát trực tiếp sử dụng. |
fileDetails.videoStreams[].bitrateBps |
unsigned longTốc độ bit của luồng video, tính bằng bit/giây. |
fileDetails.videoStreams[].rotation |
stringMức độ mà YouTube cần xoay nội dung nguồn ban đầu để hiển thị video đúng cách. Các giá trị hợp lệ cho thuộc tính này là:
|
fileDetails.videoStreams[].vendor |
stringGiá trị xác định duy nhất một nhà cung cấp video. Thông thường, giá trị này là mã nhà cung cấp gồm 4 chữ cái. |
fileDetails.audioStreams[] |
listDanh sách các luồng âm thanh có trong tệp video đã tải lên. Mỗi mục trong danh sách chứa siêu dữ liệu chi tiết về một luồng âm thanh. |
fileDetails.audioStreams[].channelCount |
unsigned integerSố lượng kênh âm thanh có trong luồng. |
fileDetails.audioStreams[].codec |
stringBộ mã hoá và giải mã âm thanh mà luồng sử dụng. |
fileDetails.audioStreams[].bitrateBps |
unsigned longTốc độ bit của luồng âm thanh, tính bằng bit/giây. |
fileDetails.audioStreams[].vendor |
stringGiá trị xác định duy nhất một nhà cung cấp video. Thông thường, giá trị này là mã nhà cung cấp gồm 4 chữ cái. |
fileDetails.durationMs |
unsigned longThời lượng của video đã tải lên, tính bằng mili giây. |
fileDetails.bitrateBps |
unsigned longTốc độ bit kết hợp (video và âm thanh) của tệp video đã tải lên, tính bằng bit/giây. |
fileDetails.creationTime |
stringNgày và giờ tạo tệp video đã tải lên. Giá trị được chỉ định ở định dạng ISO 8601. Hiện tại, chúng tôi hỗ trợ các định dạng ISO 8601 sau:
|
processingDetails |
objectĐối tượng processingDetails đóng gói thông tin về tiến trình của YouTube trong việc xử lý tệp video đã tải lên. Các thuộc tính trong đối tượng xác định trạng thái xử lý hiện tại và thời gian ước tính còn lại cho đến khi YouTube hoàn tất quá trình xử lý video. Phần này cũng cho biết liệu các loại dữ liệu hoặc nội dung khác nhau (chẳng hạn như thông tin chi tiết về tệp hoặc hình thu nhỏ) có được cung cấp cho video hay không.Đối tượng processingProgress được thiết kế để thăm dò ý kiến nhằm giúp video được tải lên có thể theo dõi tiến trình xử lý tệp video đã tải lên của YouTube. Chỉ chủ sở hữu video mới có thể truy xuất dữ liệu này. |
processingDetails.processingStatus |
stringTrạng thái xử lý của video. Giá trị này cho biết YouTube đã xử lý xong video hay video vẫn đang được xử lý. Các giá trị hợp lệ cho thuộc tính này là:
|
processingDetails.processingProgress |
objectĐối tượng processingProgress chứa thông tin về tiến trình xử lý video của YouTube. Các giá trị này chỉ thực sự phù hợp nếu trạng thái xử lý của video là processing. |
processingDetails.processingProgress.partsTotal |
unsigned longSố lượng ước tính của tổng số phần cần xử lý cho video. Số này có thể được cập nhật bằng số liệu ước tính chính xác hơn trong khi YouTube xử lý video. |
processingDetails.processingProgress.partsProcessed |
unsigned longSố phần của video mà YouTube đã xử lý. Bạn có thể ước tính tỷ lệ phần trăm video mà YouTube đã xử lý bằng cách tính: 100 * parts_processed / parts_totalXin lưu ý rằng vì số lượng phần ước tính có thể tăng lên mà không có mức tăng tương ứng về số lượng phần đã được xử lý, nên có thể tiến trình tính toán sẽ giảm định kỳ trong khi YouTube xử lý video. |
processingDetails.processingProgress.timeLeftMs |
unsigned longThời gian ước tính (tính bằng mili giây) mà YouTube cần để hoàn tất quá trình xử lý video. |
processingDetails.processingFailureReason |
stringLý do YouTube không xử lý được video. Thuộc tính này sẽ chỉ có giá trị nếu giá trị của thuộc tính processingStatus là failed.Các giá trị hợp lệ cho thuộc tính này là:
|
processingDetails.fileDetailsAvailability |
stringGiá trị này cho biết liệu thông tin chi tiết về tệp có sẵn cho video đã tải lên hay không. Bạn có thể truy xuất thông tin chi tiết về tệp của video bằng cách yêu cầu phần fileDetails trong yêu cầu videos.list(). |
processingDetails.processingIssuesAvailability |
stringGiá trị này cho biết liệu công cụ xử lý video đã tạo ra các đề xuất có thể cải thiện khả năng xử lý video của YouTube, các cảnh báo giải thích vấn đề xử lý video hay các lỗi gây ra vấn đề xử lý video hay chưa. Bạn có thể truy xuất các đề xuất này bằng cách yêu cầu phần suggestions trong yêu cầu videos.list(). |
processingDetails.tagSuggestionsAvailability |
stringGiá trị này cho biết liệu có đề xuất từ khoá (thẻ) cho video hay không. Bạn có thể thêm thẻ vào siêu dữ liệu của video để giúp người dùng khác dễ dàng tìm thấy video đó. Bạn có thể truy xuất các đề xuất này bằng cách yêu cầu phần suggestions trong yêu cầu videos.list(). |
processingDetails.editorSuggestionsAvailability |
stringGiá trị này cho biết video có đề xuất chỉnh sửa video hay không. Những đề xuất này có thể cải thiện chất lượng video hoặc trải nghiệm phát. Bạn có thể truy xuất các đề xuất này bằng cách yêu cầu phần suggestions trong yêu cầu videos.list(). |
processingDetails.thumbnailsAvailability |
stringGiá trị này cho biết hình thu nhỏ đã được tạo cho video hay chưa. |
suggestions |
objectĐối tượng suggestions đóng gói các đề xuất xác định cơ hội cải thiện chất lượng video hoặc siêu dữ liệu cho video đã tải lên. Chỉ chủ sở hữu video mới có thể truy xuất dữ liệu này. Đối tượng suggestions sẽ chỉ được trả về nếu thuộc tính processingDetails.tagSuggestionsAvailability hoặc thuộc tính processingDetails.editorSuggestionsAvailability có giá trị là available. |
suggestions.processingErrors[] |
listDanh sách lỗi khiến YouTube không thể xử lý thành công video đã tải lên. Những lỗi này cho biết rằng, bất kể trạng thái xử lý hiện tại của video là gì, thì cuối cùng, trạng thái đó gần như chắc chắn sẽ là failed.Các giá trị hợp lệ cho thuộc tính này là:
|
suggestions.processingWarnings[] |
listDanh sách các lý do khiến YouTube có thể gặp khó khăn khi chuyển mã video đã tải lên hoặc có thể dẫn đến việc chuyển mã bị lỗi. Những cảnh báo này được đưa ra trước khi YouTube thực sự xử lý tệp video đã tải lên. Ngoài ra, các giá trị này còn xác định những vấn đề không nhất thiết cho thấy quá trình xử lý video sẽ không thành công nhưng vẫn có thể gây ra sự cố, chẳng hạn như sự cố đồng bộ hoá, lỗi video hoặc thiếu bản âm thanh. Các giá trị hợp lệ cho thuộc tính này là:
|
suggestions.processingHints[] |
listDanh sách các đề xuất có thể cải thiện khả năng xử lý video của YouTube. Các giá trị hợp lệ cho thuộc tính này là:
|
suggestions.tagSuggestions[] |
listDanh sách các thẻ từ khoá có thể được thêm vào siêu dữ liệu của video để tăng khả năng người dùng tìm thấy video của bạn khi tìm kiếm hoặc duyệt xem trên YouTube. |
suggestions.tagSuggestions[].tag |
stringThẻ từ khoá được đề xuất cho video. |
suggestions.tagSuggestions[].categoryRestricts[] |
listMột nhóm danh mục video mà thẻ này có liên quan. Bạn có thể sử dụng thông tin này để hiển thị các đề xuất thẻ phù hợp dựa trên danh mục video mà người tải video lên liên kết với video. Theo mặc định, các đề xuất thẻ sẽ phù hợp với tất cả danh mục nếu không có quy định hạn chế nào đối với từ khoá. |
suggestions.editorSuggestions[] |
listDanh sách các thao tác chỉnh sửa video có thể cải thiện chất lượng video hoặc trải nghiệm phát video của video đã tải lên. Các giá trị hợp lệ cho thuộc tính này là:
|
liveStreamingDetails |
objectĐối tượng liveStreamingDetails chứa siêu dữ liệu về một chương trình phát video trực tiếp. Đối tượng này sẽ chỉ xuất hiện trong tài nguyên video nếu video là một sự kiện phát sóng trực tiếp sắp diễn ra, đang diễn ra hoặc đã hoàn tất. |
liveStreamingDetails.actualStartTime |
datetimeThời gian thực tế mà sự kiện phát sóng bắt đầu. Giá trị được chỉ định ở định dạng ISO 8601. Giá trị này sẽ chỉ có sau khi chương trình phát sóng bắt đầu. |
liveStreamingDetails.actualEndTime |
datetimeThời gian thực tế mà chương trình phát sóng kết thúc. Giá trị được chỉ định ở định dạng ISO 8601. Giá trị này sẽ chỉ có sau khi buổi phát sóng kết thúc. |
liveStreamingDetails.scheduledStartTime |
datetimeThời gian dự kiến bắt đầu phát sóng. Giá trị được chỉ định ở định dạng ISO 8601. |
liveStreamingDetails.scheduledEndTime |
datetimeThời gian dự kiến kết thúc chương trình phát sóng. Giá trị được chỉ định ở định dạng ISO 8601. Nếu giá trị trống hoặc không có thuộc tính, thì chương trình phát sóng sẽ được lên lịch tiếp tục vô thời hạn. |
liveStreamingDetails.concurrentViewers |
unsigned longSố người xem chương trình phát sóng tại thời điểm yêu cầu. Số liệu này bao gồm cả những người cùng xem khi nhiều người cùng xem trên một màn hình TV. Thuộc tính và giá trị của thuộc tính sẽ xuất hiện nếu chương trình phát sóng có người xem hiện tại và chủ sở hữu chương trình phát sóng chưa ẩn số lượt xem của video. Xin lưu ý rằng YouTube sẽ ngừng theo dõi số người xem đồng thời cho một sự kiện phát sóng khi sự kiện đó kết thúc. Do đó, thuộc tính này sẽ không xác định số lượng người xem đang xem video lưu trữ của một chương trình phát sóng trực tiếp đã kết thúc. Số lượt xem đồng thời mà YouTube Data API trả về có thể khác với số lượt xem đồng thời đã được xử lý và loại bỏ nội dung rác trong YouTube Analytics. Tìm hiểu thêm về các chỉ số của sự kiện phát trực tiếp trong
Trung tâm trợ giúp của YouTube.
|
liveStreamingDetails.activeLiveChatId |
stringMã nhận dạng của Trò chuyện trong sự kiện phát trực tiếp hiện đang hoạt động và được liên kết với video này. Trường này chỉ được điền nếu video là một sự kiện phát sóng trực tiếp hiện có tính năng Trò chuyện trong sự kiện phát trực tiếp. Sau khi chương trình phát sóng chuyển sang trạng thái hoàn tất, trường này sẽ bị xoá và Trò chuyện trong sự kiện phát trực tiếp sẽ kết thúc. Đối với các sự kiện phát sóng cố định, mã Trò chuyện trong sự kiện phát trực tiếp đó sẽ không còn liên kết với video này mà sẽ liên kết với video mới đang xuất hiện trên trang cố định. |
brandPartner |
objectĐối tượng brandPartner chứa thông tin chi tiết về đối tác thương hiệu được liên kết với video cho Quyền truy cập cho đối tác thương hiệu do nhà sáng tạo cấp (CI BPA). |
brandPartner.channelId |
stringMã nhận dạng kênh bên ngoài của đối tác thương hiệu. Trường này phải bắt đầu bằng "UC". Bạn phải đặt channelId hoặc channelHandle khi thiết lập quyền truy cập, nhưng chỉ channelId được trả về trong phản hồi. |
brandPartner.channelHandle |
stringTên người dùng của đối tác thương hiệu. Trường này phải bắt đầu bằng "@". Bạn phải đặt channelId hoặc channelHandle khi thiết lập quyền truy cập, nhưng chỉ channelId được trả về trong phản hồi. |
localizations |
objectĐối tượng localizations chứa bản dịch siêu dữ liệu của video. |
localizations.(key) |
objectNgôn ngữ của văn bản đã bản địa hoá liên kết với giá trị khoá. Giá trị là một chuỗi chứa mã ngôn ngữ BCP-47. |
localizations.(key).title |
stringTiêu đề video đã bản địa hoá. |
localizations.(key).description |
stringNội dung mô tả video đã bản địa hoá. |