Tất cả video được tải lên thông qua điểm cuối
videos.insert
từ các dự án API chưa được xác minh được tạo sau ngày 28 tháng 7 năm 2020 sẽ bị giới hạn ở chế độ xem riêng tư. Để gỡ bỏ quy định hạn chế này, mỗi dự án API phải
trải qua quy trình kiểm tra để xác minh
tình trạng tuân thủ Điều khoản dịch vụ. Vui lòng xem Nhật ký sửa đổi API để biết thêm thông tin chi tiết.
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
- Truy xuất điểm xếp hạng mà người dùng được uỷ quyền đã đưa ra cho danh sách video được chỉ định. Thử ngay.
- list
- Trả về danh sách video khớp với các tham số yêu cầu API. Thử ngay.
- chèn
- Tải video lên YouTube và tuỳ ý đặt siêu dữ liệu của video.
- update
- Cập nhật siêu dữ liệu của video. Thử ngay.
- xóa
- Xoá video trên YouTube. Thử ngay.
- rate
- Thêm điểm xếp hạng thích hoặc không thích cho một video hoặc xoá điểm xếp hạng khỏi một video. Thử ngay.
- reportAbuse
- Báo cáo video có chứa nội dung sai trái. Thử ngay.
Biểu diễn 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 }, "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#video . |
etag |
etag Etag của tài nguyên này. |
id |
string Mã nhận dạng mà YouTube sử dụng để xác định riêng biệt video. |
snippet |
object Đối tượng snippet chứa các thông tin cơ bản về video, chẳng hạn như tiêu đề, nội dung mô tả và danh mục. |
snippet.publishedAt |
datetime Ngày và giờ xuất bản video. Xin lưu ý rằng thời gian này có thể khác với thời gian tải video lên. Ví dụ: nếu một video được tải lên ở chế độ riêng tư rồi sau đó 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 |
string Mã nhận dạng mà YouTube sử dụng để nhận dạng duy nhất kênh mà video được tải lên. |
snippet.title |
string Tiê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ả 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 |
string Nộ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ả ký tự UTF-8 hợp lệ ngoại trừ < và >. |
snippet.thumbnails |
object Bản đồ 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 ả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) |
object Khoá hợp lệ có các giá trị sau:
|
snippet.thumbnails.(key).url |
string URL của hình ảnh. |
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.channelTitle |
string Tên kênh của kênh chứa video đó. |
snippet.tags[] |
list Danh sách 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 ý các quy tắc sau đây liên quan đến cách tính hạn mức ký tự:
|
snippet.categoryId |
string Danh 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 |
string Cho biết video có phải là video phát sóng trực tiếp sắp ra mắt/đang hoạt động hay không. Hoặc giá trị này có giá trị "không có" nếu video không phải là sự kiện phát sóng trực tiếp sắp tới/đang hoạt động. Các giá trị hợp lệ cho thuộc tính này là:
|
snippet.defaultLanguage |
string Ngôn ngữ của văn bản trong 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á của 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á các tiêu đề đã bản địa hoá. |
snippet.localized.title |
string Tiêu đề video đã bản địa hoá. |
snippet.localized.description |
string Nội dung mô tả video đã được bản địa hoá. |
snippet.defaultAudioLanguage |
string Thuộ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à cho biết video có phụ đề hay không. |
contentDetails.duration |
string Thời lượng của video. Giá trị thuộc tính là thời lượng theo chuẩn ISO 8601. Ví dụ: đối với video có thời lượng ít nhất 1 phút và dưới 1 giờ, thời lượng sẽ có định dạng PT#M#S , trong đó chữ cái PT cho biết giá trị này chỉ định một khoảng thời gian và chữ cái M và S lần lượt đề cập đến 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 có thời lượng 15 phút 33 giây.Nếu video có thời lượng ít nhất một giờ, thời lượng sẽ có định dạng PT#H#M#S , trong đó # đứng trước chữ H chỉ định thời lượng của video theo giờ và tất cả các thông tin 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ị sẽ là P#DT#H#M#S . Vui lòng tham khảo thông số kỹ thuật ISO 8601 để biết đầy đủ chi tiết. |
contentDetails.dimension |
string Cho biết video có ở định dạng 3D hay 2D. |
contentDetails.definition |
string Cho biết video có ở độ phân giải cao ( HD ) hay chỉ ở độ phân giải chuẩn.Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.caption |
string Cho 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 |
boolean Cho biết video có đại diện cho nội dung được cấp phép hay không, tức là nội dung đó được tải lên kênh liên kết với một đối tác nội dung YouTube, sau đó đố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 mà 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[] |
list Danh sách mã khu vực xác định các quốc gia có thể xem video. Nếu có thuộc tính này 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ó 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[] |
list Danh sách mã khu vực xác định những quốc gia nơi video bị chặn. Nếu thuộc tính này có và không có quốc gia nào được liệt kê trong giá trị của thuộc tính đó, thì người dùng có thể xem video ở quốc gia đó. Nếu tài sản này xuất hiện và chứa danh sách trống, thì video đó có thể xem được ở tất cả các quốc gia. |
contentDetails.contentRating |
object Chỉ định các mức phân loại mà video nhận được theo nhiều hệ thống phân loại. |
contentDetails.contentRating.acbRating |
string Mức phân loại của video theo Ủy ban phân loại Úc (ACB) hoặc Cơ quan truyền thông và truyền thông Úc (ACMA). Mức 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 |
string Mức phân loại của video theo Autorità per le Garanzie nelle Comunicazioni (AGCOM) của Ý. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.anatelRating |
string Điểm xếp hạng Anatel (Asociación Nacional de Televisión) của video đối với truyền hình Chile. Các giá trị hợp lệ cho cơ sở lưu trú này là:
|
contentDetails.contentRating.bbfcRating |
string Mức phân loại của British Board of Film Classification (BBFC) đối với video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.bfvcRating |
string Mức phân loại của video theo Hội đồng kiểm duyệt phim và video của Thái Lan. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.bmukkRating |
string Mức phân loại của video theo Ủy ban phân loại nội dung nghe nhìn của Áo (Bundesministerium für Unterricht, Kunst und Kultur). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.catvRating |
string Hệ thống phân loại dành cho truyền hình Canada – Canadian TV Classification System (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 Ủy ban Truyền hình, Đài phát thanh và Viễn thông Canada (CRTC) đưa ra đối với 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 Canadian Broadcast Standards Council (Hội đồng Tiêu chuẩn Truyền hình Canada). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.catvfrRating |
string Mức phân loại của video theo Ủy ban Truyền hình, Phát thanh và Viễn thông Canada (CRTC) đối với 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 |
string Mức phân loại của Hội đồng phân loại phim trung ương (CBFC – Ấn Độ) đối với video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.cccRating |
string Mức phân loại của Consejo de Calificación Cinematográfica (Chile) đối với video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.cceRating |
string Mứ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 |
string Điểm xếp hạng của video ở Thuỵ Sĩ. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.chvrsRating |
string Mức phân loại của Hệ thống phân loại video gia đình Canada (CHVRS) đối với video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.cicfRating |
string Mức phân loại của video do Commission de Contrôle des Films (Bỉ) cung cấp. Giá trị hợp lệ cho cơ sở lưu trú này là:
|
contentDetails.contentRating.cnaRating |
string Mứ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 |
string Hệ thống phân loại ở Pháp – Ủy ban phân loại điện ảnh (Uỷ ban phân loại điện ảnh) Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.csaRating |
string Mức phân loại của video theo Conseil supérieur de l?audiovisuel của Pháp. Tổ chức này 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 |
string Mức phân loại của video theo Ủy ban giám sát phân loại phim (CSCF) của Luxembourg. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.czfilmRating |
string Mức phân loại của video ở Cộng hoà Séc. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.djctqRating |
string Mức phân loại của Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT – Brazil) đối với video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.djctqRatingReasons[] |
list Lý do giải thích vì sao video đó nhận được mức phân loại của DJCQT (Brazil). |
contentDetails.contentRating.ecbmctRating |
string Hệ thống phân loại ở Thổ Nhĩ Kỳ – Hội đồng đánh giá và phân loại thuộc Bộ Văn hoá và Du lịch Các giá trị hợp lệ cho cơ sở lưu trú này là:
|
contentDetails.contentRating.eefilmRating |
string Mứ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 |
string Điểm xếp hạng của video tại Ai Cập. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.eirinRating |
string Mức phân loại Eirin (映倫) của video. Eirin là hệ thống phân loại của Nhật Bản. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.fcbmRating |
string Mức phân loại của video theo Hội đồng kiểm duyệt phim của Malaysia. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.fcoRating |
string Mức phân loại của video theo Cục Quản lý phim, báo và bài viết của Hồng Kông. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.fmocRating |
string Tài sản này đã ngừng hoạt động 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 |
string Mức phân loại của video theo Hội đồng kiểm duyệt phim và ấn phẩm của Nam Phi. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.fpbRatingReasons[] |
list Lý 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 |
string Mức phân loại của Freiwillige Selbstkontrolle der Filmwirtschaft (FSK – Đức) đối với video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.grfilmRating |
string Mứ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 |
string Mức phân loại của Instituto de la Cinematografía y de las Artes AudioVisuales (ICAA – Tây Ban Nha) của video. Các giá trị hợp lệ cho tài sản này là:
|
contentDetails.contentRating.ifcoRating |
string Mức phân loại của Văn phòng phân loại phim Ireland (IFCO – Ireland) của video này. 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 |
string Mứ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 |
string Mức phân loại theo INCAA (Instituto Nacional de Cine y Artes AudioVisuales – Argentina) của video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.kfcbRating |
string Mức phân loại của video theo Uỷ ban Phân loại phim Kenya. Các giá trị hợp lệ cho tài sản này là:
|
contentDetails.contentRating.kijkwijzerRating |
string voor 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 |
string Điểm xếp hạng của Hội đồng xếp hạng truyền thông Hàn Quốc (진진물물진츉자원어). KMRB xếp hạng các video ở Hàn Quốc. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.lsfRating |
string Mứ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 |
string Mức phân loại của video theo Hội đồng phân loại phim theo độ tuổi của Malta. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mccypRating |
string Điểm xếp hạng của video này theo Hội đồng Truyền thông dành cho Trẻ em và Thanh thiếu niên của Viện Điện ảnh Đan Mạch (Det Danske Filminstitut). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mcstRating |
string Hệ thống phân loại của video tại Việt Nam – MCST Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mdaRating |
string Mức phân loại của video theo Cơ quan Phát triển Truyền thông (MDA) của Singapore và cụ thể là Hội đồng Giám sát Phim (BFC) của Singapore. Các giá trị hợp lệ cho tài sản này là:
|
contentDetails.contentRating.medietilsynetRating |
string Điểm xếp hạng của video do Medietilsynet, Cơ quan truyền thông của Na Uy cung cấp. Các giá trị hợp lệ cho tài sản này là:
|
contentDetails.contentRating.mekuRating |
string Mức phân loại của video theo Kansallinen Audiovisuaalinen Instituutti (Viện Âm thanh và hình ảnh quốc gia) của Phần Lan. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mibacRating |
string Mức phân loại của video theo Bộ Di sản, Hoạt động văn hoá và Du lịch (Ý). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mocRating |
string Điểm xếp hạng Ministerio de Cultura (Colombia) của video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.moctwRating |
string Mức phân loại của video theo Bộ Văn hoá Đài Loan (文化部). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mpaaRating |
string Mức phân loại của Hiệp hội Điện ảnh Hoa Kỳ (MPAA) của video này. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.mpaatRating |
string Mức phân loại của Hiệp hội Điện ảnh Hoa Kỳ cho video 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 |
string Mức phân loại của video theo Hội đồng phân loại và xem xét phim và truyền hình (Philippines). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.nbcRating |
string Điểm xếp hạng của video do Cục Phân loại Quốc gia Maldives đưa ra. Giá trị hợp lệ cho cơ sở lưu trú này là:
|
contentDetails.contentRating.nfrcRating |
string Mức phân loại của video theo Trung tâm Điện ảnh Quốc gia Bulgaria. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.nfvcbRating |
string Mức phân loại của video theo Hội đồng kiểm duyệt phim và video quốc gia của Nigeria. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.nkclvRating |
string Điểm xếp hạng của video do Nacionãlais Kino centrs (Trung tâm Phim Quốc gia Latvia) cung cấp. Các giá trị hợp lệ cho cơ sở lưu trú này là:
|
contentDetails.contentRating.oflcRating |
string Mức phân loại của Cơ quan phân loại phim và văn học (OFLC – New Zealand) đối với video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.pefilmRating |
string Mứ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 |
string Mứ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 |
string Mức phân loại của Tổng cục Phát thanh, Truyền hình và Điện ảnh (Mexico) đối với video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.rteRating |
string Mứ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 |
string Mức phân loại của Cơ quan đăng ký phim quốc gia thuộc Liên bang Nga (MKRF – Nga) đối với video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.skfilmRating |
string Mứ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 |
string Điểm xếp hạng của video tại Iceland. Các giá trị hợp lệ cho cơ sở lưu trú này là:
|
contentDetails.contentRating.smsaRating |
string Mức phân loại của video theo Statens medieråd (Hội đồng truyền thông quốc gia của Thuỵ Điển). Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.tvpgRating |
string Mức phân loại theo Hướng dẫn dành cho cha mẹ về chương trình truyền hình (TVPG) của video. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.contentRating.ytRating |
string Mức phân loại mà YouTube sử dụng để xác định nội dung có giới hạn về độ tuổi. Các giá trị hợp lệ cho thuộc tính này là:
|
contentDetails.projection |
string Chỉ đị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 |
boolean Cho biết liệu người tải video lên đã cung cấp hình thu nhỏ tuỳ chỉnh cho video hay chưa. 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 |
string Trạng thái của video đã tải lên. Các giá trị hợp lệ cho thuộc tính này là:
|
status.failureReason |
string Giá 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 |
string Giá trị này giải thích lý do YouTube từ chối một video được 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 nội dung 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 |
string Trạng thái quyền riêng tư của video. Các giá trị hợp lệ cho thuộc tính này là:
|
status.publishAt |
datetime Ngày và giờ lên lịch xuất bản video. Bạn chỉ có thể đặt chế độ 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. Xin lưu ý thêm hai điểm sau đây về hành vi của thuộc tính này:
|
status.license |
string Giấy phép của video. Các giá trị hợp lệ cho thuộc tính này là:
|
status.embeddable |
boolean Giá trị này cho biết liệu có thể nhúng video trên một trang web khác hay không. |
status.publicStatsViewable |
boolean Giá trị này cho biết liệu số liệu thống kê mở rộng của video trên trang xem của video có thể xem 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ẽ xuất hiện công khai ngay cả khi bạn đặt giá trị của thuộc tính này thành false . |
status.madeForKids |
boolean Giá trị này cho biết liệu video có được chỉ định là video 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 . Truy cập vào
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.
|
status.selfDeclaredMadeForKids |
boolean Trong 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à video hướng tới 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 |
boolean Trong 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 Đã chỉnh sửa hoặc
Nhân tạo (A/S) trông giố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 sửa chữa và bảo dưỡng.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 long Số lượt xem video. |
statistics.likeCount |
unsigned long Số người dùng đã cho biết rằng họ thích video đó. |
statistics.dislikeCount |
unsigned long Lưu ý: Tài sản
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 API nếu chủ sở hữu video xác thực yêu cầu API. 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 long Lưu ý: Thuộc tính này không còn được dùng nữa. Việc ngừng sử dụng sẽ 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 long Số bình luận cho video. |
paidProductPlacementDetails |
object Đối tượng paidProductPlacementDetails chứa thông tin về nội dung lồng ghép sản phẩm có tính phí trong video. |
paidProductPlacementDetails.hasPaidProductPlacement |
boolean Đặt thành true nếu nội dung sử dụng hoạt động lồng ghép sản phẩm có tính phí. Giá trị mặc định là false . |
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 |
string Thẻ <iframe> nhúng trình phát để phát video.
|
player.embedHeight |
long Chiề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 các tham số maxHeight và/hoặc maxWidth và xác định được tỷ lệ khung hình của video. |
player.embedWidth |
long Chiề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 các thông 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 chứa thông tin về các chủ đề liên quan đến video.Lưu ý quan trọng: Hãy xem định nghĩa của 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[] |
list Quan trọng: Thuộc tính này đã ngừng hoạt động kể từ ngày 10 tháng 11 năm 2016. API không còn trả về các giá trị cho thuộc tính này nữa và mọi chủ đề liên kết với video hiện được giá trị thuộc tính topicDetails.relevantTopicIds[] trả về. |
topicDetails.relevantTopicIds[] |
list Danh sách mã chủ đề có liên quan đến video. Tài sản này đã ngừng hoạt động kể từ ngày 10 tháng 11 năm 2016. API này sẽ được hỗ trợ cho đến hết ngày 10 tháng 11 năm 2017. Lưu ý quan trọng: Do Freebase và API Freebase không còn được dùng nữa, 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ỏ các mã chủ đề được tuyển chọn. |
topicDetails.topicCategories[] |
list Danh sách các URL của Wikipedia cung cấp thông tin mô tả bao quát về nội dung của video. |
recordingDetails |
object Đối tượng recordingDetails chứa thông tin về vị trí, ngày và địa chỉ nơi quay video. |
recordingDetails.locationDescription |
string Tài sản này đã ngừng hoạt động kể từ ngày 1 tháng 6 năm 2017. Vui lòng xem thông báo về việc không dùng nữa để 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 |
object Thông tin vị trí địa lý liên kết với video. Xin lưu ý rằng giá trị 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, tìm kiếm giá trị này trên video công khai và giá trị này có thể hiển thị với người dùng đối với video công khai. |
recordingDetails.location.latitude |
double Thuộ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 không dùng nữa để biết thêm thông tin chi tiết. Vĩ độ tính bằng độ. |
recordingDetails.location.longitude |
double Thuộ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 không dùng nữa để biết thêm thông tin chi tiết. Kinh độ tính bằng độ. |
recordingDetails.location.altitude |
double Thuộ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 không dùng nữa để biết thêm thông tin chi tiết. Độ cao so với elip tham chiếu, tính bằng mét. |
recordingDetails.recordingDate |
datetime Ngà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 chứa 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.v. 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 |
string Tên của tệp đã tải lên. Trường này sẽ 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 long Kích thước của tệp đã tải lên tính bằng byte. Trường này sẽ 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 |
string Loại tệp được tải lên theo như phát hiện của công cụ xử lý video của YouTube. Hiện tại, YouTube chỉ xử lý tệp video, nhưng bạn vẫn sẽ thấy trường này dù bạn đã tải tệp video hay một loại tệp khác 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[] |
list Danh sách các luồng video có trong tệp video đã tải lên. Mỗi mục trong danh sách này chứa siêu dữ liệu chi tiết về một luồng video. |
fileDetails.videoStreams[].widthPixels |
unsigned integer Chiề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 width_pixels / height_pixels . |
fileDetails.videoStreams[].heightPixels |
unsigned integer Chiều cao của nội dung video đã mã hoá, tính bằng pixel. |
fileDetails.videoStreams[].frameRateFps |
double Tốc độ khung hình của luồng video, tính bằng khung hình/giây. |
fileDetails.videoStreams[].aspectRatio |
double Tỷ lệ khung hình hiển thị của nội dung video, cho biết tỷ lệ khung hình mà video sẽ được hiển thị. |
fileDetails.videoStreams[].codec |
string Bộ mã hoá và giải mã video mà luồng sử dụng. |
fileDetails.videoStreams[].bitrateBps |
unsigned long Tốc độ bit của luồng video, tính bằng bit mỗi giây. |
fileDetails.videoStreams[].rotation |
string Số độ mà YouTube cần xoay nội dung nguồn gốc để 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 |
string Giá trị nhận dạng 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[] |
list Danh 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 này chứa siêu dữ liệu chi tiết về một luồng âm thanh. |
fileDetails.audioStreams[].channelCount |
unsigned integer Số lượng kênh âm thanh mà luồng chứa. |
fileDetails.audioStreams[].codec |
string Bộ mã hoá và giải mã âm thanh mà luồng sử dụng. |
fileDetails.audioStreams[].bitrateBps |
unsigned long Tốc độ bit của luồng âm thanh, tính bằng bit mỗi giây. |
fileDetails.audioStreams[].vendor |
string Giá trị nhận dạng 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 long Thời lượng của video đã tải lên tính bằng mili giây. |
fileDetails.bitrateBps |
unsigned long Tốc độ bit kết hợp (video và âm thanh) của tệp video đã tải lên, tính bằng bit mỗi giây. |
fileDetails.creationTime |
string Ngày và giờ tạo tệp video được 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 chứa thông tin về tiến trình xử lý tệp video đã tải lên của YouTube. Các thuộc tính trong đối tượng này cho biết 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 xử lý xong video. Phần này cũng cho biết liệu video có 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ỏ) hay không.Đối tượng processingProgress được thiết kế để thăm dò ý kiến để video được tải lên có thể theo dõi tiến trình mà YouTube đã thực hiện trong quá trình xử lý tệp video đã tải lên. Chỉ chủ sở hữu video mới có thể truy xuất dữ liệu này. |
processingDetails.processingStatus |
string Trạng thái xử lý của video. Giá trị này cho biết liệu YouTube có thể xử lý video hay không hoặc 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ự có liên quan nếu trạng thái xử lý của video là processing . |
processingDetails.processingProgress.partsTotal |
unsigned long Số phần cần xử lý ước tính cho video. Số liệu 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 long Số 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_total Xin lưu ý rằng vì số lượng phần ước tính có thể tăng mà số lượng phần đã xử lý không tăng tương ứng, nên tiến trình được tính có thể giảm định kỳ trong khi YouTube xử lý video. |
processingDetails.processingProgress.timeLeftMs |
unsigned long Thờ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 |
string Lý do khiến 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 |
string Giá trị này cho biết liệu video đã tải lên có thông tin chi tiết về tệp hay không. Bạn có thể truy xuất thông tin chi tiết về tệp của một video bằng cách yêu cầu phần fileDetails trong yêu cầu videos.list() . |
processingDetails.processingIssuesAvailability |
string Giá trị này cho biết liệu công cụ xử lý video có tạo ra các đề xuất có thể cải thiện khả năng xử lý video của YouTube, cảnh báo giải thích các vấn đề về việc xử lý video hay lỗi gây ra vấn đề về việc xử lý video hay không. 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 |
string Giá 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() của mình. |
processingDetails.editorSuggestionsAvailability |
string Giá trị này cho biết video có các đề xuất chỉnh sửa video (có thể cải thiện chất lượng video hoặc trải nghiệm phát) hay không. 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() của mình. |
processingDetails.thumbnailsAvailability |
string Giá trị này cho biết liệu video đã được tạo hình thu nhỏ hay chưa. |
suggestions |
object Đối tượng suggestions bao gồm các đề xuất giúp 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[] |
list Danh sách các lỗi sẽ 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[] |
list Danh sách các lý do có thể khiến YouTube 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ã không chính xác. Những cảnh báo này được tạo 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 xác định những vấn đề không nhất thiết cho biết quá trình xử lý video sẽ không thành công nhưng vẫn có thể gây ra các vấn đề như vấn đề đồng bộ hoá, hiện tượng video bị méo hoặc thiếu kênh âm thanh. Các giá trị hợp lệ cho thuộc tính này là:
|
suggestions.processingHints[] |
list Danh sách các đề xuất có thể giúp YouTube xử lý video hiệu quả hơn. Các giá trị hợp lệ cho thuộc tính này là:
|
suggestions.tagSuggestions[] |
list Danh sách các thẻ từ khoá có thể 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 |
string Thẻ từ khoá được đề xuất cho video. |
suggestions.tagSuggestions[].categoryRestricts[] |
list Mộ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ẻ có liên quan cho tất cả các danh mục nếu không có hạn chế nào được xác định cho từ khoá. |
suggestions.editorSuggestions[] |
list Danh sách hoạt động chỉnh sửa video có thể cải thiện chất lượng 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 sự kiện phát trực tiếp video. Đối tượng sẽ chỉ xuất hiện trong tài nguyên video nếu video đó là buổi phát sóng trực tiếp sắp diễn ra, đang trực tiếp hoặc đã kết thúc. |
liveStreamingDetails.actualStartTime |
datetime Thời gian thực sự bắt đầu phát sóng. Giá trị được chỉ định ở định dạng ISO 8601. Bạn sẽ không thấy giá trị này cho đến khi sự kiện phát sóng bắt đầu. |
liveStreamingDetails.actualEndTime |
datetime Thời điểm chương trình phát sóng thực sự kết thúc. Giá trị được chỉ định ở định dạng ISO 8601. Bạn sẽ không thấy giá trị này cho đến khi sự kiện phát sóng kết thúc. |
liveStreamingDetails.scheduledStartTime |
datetime Thời gian bắt đầu phát sóng theo lịch. Giá trị được chỉ định ở định dạng ISO 8601. |
liveStreamingDetails.scheduledEndTime |
datetime Thờ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ị này trống hoặc không có thuộc tính, thì thông báo truyền tin sẽ được lên lịch tiếp tục vô thời hạn. |
liveStreamingDetails.concurrentViewers |
unsigned long Số người hiện đang xem chương trình phát sóng. Thuộc tính này 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ố lượng người xem đồng thời cho một sự kiện phát sóng khi sự kiện phát sóng kết thúc. Vì vậy, thuộc tính này sẽ không xác định được số người xem video được lưu trữ của một chương trình phát sóng trực tiếp đã kết thúc. Số người xem đồng thời mà YouTube Data API trả về có thể khác với số người xem đồng thời đã được xử lý và loại bỏ nội dung rác thông qua 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 |
string Mã của cuộc trò chuyện trực tiếp đang hoạt động được đính kèm vào video này. Trường này chỉ được điền nếu video là một sự kiện phát trực tiếp đang diễn ra và có tính năng trò chuyện trực tiếp. Sau khi sự kiện phát trực tiếp kết thúc, trường này sẽ bị xoá và cuộc trò chuyện trực tiếp sẽ đóng lại. Đối với các sự kiện phát trực tiếp liên tục, mã cuộc trò chuyện 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 hiển thị trên trang liên tục. |
localizations |
object Đối tượng localizations chứa bản dịch siêu dữ liệu của video. |
localizations.(key) |
object Ngô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 |
string Tiêu đề video đã bản địa hoá. |
localizations.(key).description |
string Nội dung mô tả video đã được bản địa hoá. |