Videos

Tất cả video được tải lên 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ị hạn chế ở chế độ xem riêng tư. Để gỡ bỏ quy định hạn chế này, mỗi dự án API đều phải trải qua một cuộc kiểm tra để xác minh việc 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 chi tiết.

Tài nguyên video đại diện cho một video trên YouTube.

Phương thức

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

getRating

Truy xuất mức phân loại mà người dùng được cấp phép đã đánh giá cho danh sách các video đã chỉ định. Thử ngay.

list

Trả về danh sách video khớp với tham số yêu cầu của API. Thử ngay.

chèn

Tải video lên YouTube và thiết lập siêu dữ liệu của video nếu muốn.

cập nhật

Cập nhật siêu dữ liệu của video. Thử ngay.

xóa

Xóa 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 xóa lượt xếp hạng khỏi video. Thử ngay.

reportLạm dụng

Báo cáo video vì có chứa nội dung lạm dụng. 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
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "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 dùng để xác định riêng từng 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 của video.
snippet.publishedAt	datetime Ngày và giờ xuất bản video đó. Xin lưu ý rằng thời điểm này có thể khác với thời điểm video được tải lên. Ví dụ: Nếu một video được tải lên dưới dạng video riêng tư rồi sau đó chuyển sang chế độ công khai sau đó, thì tài sản này sẽ chỉ định thời điểm chuyển video đó sang chế độ công khai. Có một số trường hợp đặc biệt: Nếu một video được tải lên dưới dạng video riêng tư và chủ sở hữu kênh truy xuất siêu dữ liệu video thì giá trị thuộc tính sẽ chỉ định ngày và giờ mà video được tải lên. Nếu một video được tải lên dưới dạng video không công khai, giá trị thuộc tính cũng chỉ định ngày và giờ mà video đó được tải lên. Trong trường hợp này, bất kỳ ai biết mã video duy nhất của video đều có thể truy xuất siêu dữ liệu của video đó. Giá trị được chỉ định ở định dạng ISO 8601.
snippet.channelId	string Mã nhận dạng mà YouTube dùng để xác định riêng biệt kênh nơi 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ả 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	string Nội dung mô tả của video. Giá trị thuộc tính có độ dài tối đa là 5000 byte và có thể chứa tất cả các ký tự UTF-8 hợp lệ ngoại trừ < và >.
snippet.thumbnails	object Bản đồ các 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)	object Các giá trị khoá hợp lệ là: default – Hình thu nhỏ mặc định. Hình thu nhỏ mặc định cho video – hoặc tài nguyên đề cập đến video, chẳng hạn như mục trong danh sách phát hoặc kết quả tìm kiếm – có chiều rộng 120px và chiều cao 90px. Hình thu nhỏ mặc định của kênh có chiều rộng 88px và chiều cao 88px. medium – Phiên bản hình thu nhỏ có độ phân giải cao hơn. Đối với video (hoặc tài nguyên đề cập đến video), hình ảnh này có chiều rộng là 320px và chiều cao là 180px. Đối với kênh, hình ảnh này có chiều rộng 240px và chiều cao 240px. high – Phiên bản hình thu nhỏ có độ phân giải cao. Đối với video (hoặc tài nguyên đề cập đến video), hình ảnh này có chiều rộng là 480px và chiều cao là 360px. Đối với kênh, hình ảnh này có chiều rộng là 800px và chiều cao là 800px. standard – Phiên bản hình thu nhỏ có độ phân giải thậm chí cao hơn so với hình ảnh có độ phân giải high. Hình ảnh này hoạt động trên một số video và tài nguyên khác liên quan đến video, chẳng hạn như các mục trong danh sách phát hoặc kết quả tìm kiếm. Hình ảnh này rộng 640px và cao 480px. maxres – Phiên bản hình thu nhỏ có độ phân giải cao nhất. Kích thước hình ảnh này áp dụng cho một số video và tài nguyên khác liên quan đến video, chẳng hạn như các mục trong danh sách phát hoặc kết quả tìm kiếm. Hình ảnh này rộng 1280px và cao 720px.
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 Tiêu đề kênh của kênh có 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 về cách tính giới hạn ký tự: Giá trị thuộc tính là một danh sách, và dấu phẩy giữa các mục trong danh sách được tính vào hạn mức. Nếu một thẻ chứa khoảng trắng, thì máy chủ API sẽ xử lý giá trị thẻ như thể thẻ được đặt trong dấu ngoặc kép và dấu ngoặc kép sẽ được tính vào giới hạn ký tự. Vì vậy, để đảm bảo giới hạn ký tự, thẻ Foo-Baz chứa 7 ký tự, nhưng thẻ Foo Baz chứa 9 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 này có phải là video phát sóng trực tiếp sắp diễn ra/đang hoạt động hay không. Hoặc giá trị sẽ là "không có" nếu video đó không phải là một chương trình phát sóng trực tiếp sắp diễn ra/đang hoạt động. Các giá trị hợp lệ cho tài sản này là: live none upcoming
snippet.defaultLanguage	string Ngô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 bằng ngôn ngữ mặc định cho siêu dữ liệu của video. Văn bản đã bản địa hoá sẽ được trả về trong đoạn mã tài nguyên nếu yêu cầu videos.list sử dụng tham số hl để chỉ định ngôn ngữ cần trả về văn bản đã bản địa hoá và văn bản đã bản địa hoá sẽ có sẵn bằng ngôn ngữ đó. Siêu dữ liệu cho ngôn ngữ mặc định sẽ được trả về nếu giá trị tham số hl không được chỉ định hoặc một giá trị được chỉ định nhưng không có siêu dữ liệu đã bản địa hoá cho ngôn ngữ đã chỉ định. Thuộc tính chứa giá trị chỉ có thể đọc. Sử dụng đối tượng localizations để thêm, cập nhật hoặc xoá các cuốn sách đã được bản địa hoá.
snippet.localized.title	string Tiêu đề của video được bản địa hoá.
snippet.localized.description	string Nội dung mô tả video đã bản địa hoá.
snippet.defaultAudioLanguage	string Thuộc tính default_audio_language chỉ định ngôn ngữ 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 video. Giá trị thuộc tính là một khoảng thời gian ISO 8601. Ví dụ: Đối với video có thời lượng tối thiểu 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 tương ứng với 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ời lượng sẽ ở định dạng PT#H#M#S, trong đó # đứng trước chữ cái H chỉ định thời lượng của video theo giờ và tất cả các chi tiết khác 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 thông số kỹ thuật ISO 8601 để biết toàn bộ thông tin chi tiết.
contentDetails.dimension	string Cho biết video sẽ ở chế độ 3D hay 2D.
contentDetails.definition	string Cho biết video sẽ được cung cấp ở độ 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à: hd sd
contentDetails.caption	string Cho biết video có phụ đề hay không. Các giá trị hợp lệ của thuộc tính này là: false true
contentDetails.licensedContent	boolean Cho biết video có chứa 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, 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ề các quốc gia nơi video có thể xem được (hoặc không thể xem được). Đố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ã vùng xác định những quốc gia nơi video có thể xem được. Nếu có tài sản này và một quốc gia không được nêu trong giá trị của tài sản này, thì video sẽ không được xuất hiện ở quốc gia đó. Nếu có tài sản này và chứa một 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ã vùng giúp xác định những quốc gia nơi video bị chặn. Nếu tài sản này tồn tại và một quốc gia không được liệt kê trong giá trị của tài sản này, thì video có thể xem được ở quốc gia đó. Nếu thuộc tính này có mặt và chứa một danh sách trống, thì video có thể xem được ở tất cả các quốc gia.
contentDetails.contentRating	object Chỉ định mức phân loại mà video nhận được theo nhiều cơ chế phân loại.
contentDetails.contentRating.acbRating	string Xếp hạng của Uỷ ban phân loại Úc (ACB) hoặc Cơ quan Thông tin và Truyền thông Úc (ACMA) của video đó. Mức phân loại của ACMA 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à: acbC – Các chương trình đã được Cơ quan Thông tin và Truyền thông Úc phân loại C. Các chương trình này dành cho trẻ em (trừ trẻ em mẫu giáo) nhỏ hơn 14 tuổi. acbE – E acbG – G acbM – 3 acbMa15plus – MA15 trở lên acbP – Các chương trình đã được Cơ quan Thông tin và Truyền thông Úc phân loại P. Các chương trình này dành cho trẻ mẫu giáo. acbPg – PG acbR18plus – R18 trở lên acbUnrated
contentDetails.contentRating.agcomRating	string Điểm xếp hạng video trên trang Autorità per le Garanzie nelle Comunicazioni (AGCOM) của Ý. Các giá trị hợp lệ của cơ sở lưu trú này là: agcomT – T3 agcomUnrated agcomVm14 – VM14 agcomVm18 – VM18
contentDetails.contentRating.anatelRating	string Điểm xếp hạng của kênh Anatel (Asociación Nacional de Televisión) của kênh truyền hình Chile. Giá trị hợp lệ của cơ sở lưu trú này là: anatelA – A anatelF – T6 anatelI – Tôi anatelI10 – I-10 anatelI12 – I-12 anatelI7 – I-7 anatelR – Phải anatelUnrated
contentDetails.contentRating.bbfcRating	string Xếp hạng của Uỷ ban phân loại phim (BBFC) ở Anh đối với video đó. Các giá trị hợp lệ của thuộc tính này là: bbfc12 – 12 bbfc12a – 12A bbfc15 – 15 bbfc18 – 18 tuổi bbfcPg – PG bbfcR18 – R18 bbfcU – U bbfcUnrated
contentDetails.contentRating.bfvcRating	string Mức phân loại video của Hội đồng kiểm duyệt phim và video Thái Lan. Các giá trị hợp lệ của cơ sở lưu trú này là: bfvc13 – 13 bfvc15 – 15 bfvc18 – 18 tuổi bfvc20 – 20 bfvcB – TỶ bfvcE – E bfvcG – G bfvcUnrated
contentDetails.contentRating.bmukkRating	string Điểm xếp hạng của video do Uỷ ban phân loại truyền thông Áo (Bundesministerium für Unterricht, Kunst und Kultur) đánh giá. Các giá trị hợp lệ của tài sản này là: bmukk10 – 10 tuổi trở lên bmukk12 – 12 tuổi trở lên bmukk14 – 14 tuổi trở lên bmukk16 – 16 tuổi trở lên bmukk6 – 6 tuổi trở lên bmukk8 – 8 tuổi trở lên bmukkAa – Không hạn chế bmukkUnrated
contentDetails.contentRating.catvRating	string Hệ thống phân loại cho truyền hình Canada – Hệ thống phân loại truyền hình của 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ệ của thuộc tính này là: catv14plus – 14 tuổi trở lên catv18plus – 18 tuổi trở lên catvC – C catvC8 – C8 catvG – G catvPg – PG catvUnrated
contentDetails.contentRating.catvfrRating	string Mức phân loại của video này là do Uỷ ban Phát thanh – Truyền hình và Viễn thông Canada (CRTC) có thể làm việc này đố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ệ của thuộc tính này là: catvfr13plus – 13 tuổi trở lên catvfr16plus – 16 tuổi trở lên catvfr18plus – 18 tuổi trở lên catvfr8plus – 8 tuổi trở lên catvfrG – G catvfrUnrated
contentDetails.contentRating.cbfcRating	string Mức phân loại của Ban chứng nhận phim trung ương (CBFC – Ấn Độ) của video. Các giá trị hợp lệ của thuộc tính này là: cbfcA – A cbfcS – Nam cbfcU – U cbfcUnrated cbfcUA – Có cbfcUA7plus – Có cbfcUA13plus – Có cbfcUA16plus – Có
contentDetails.contentRating.cccRating	string Điểm xếp hạng của Consejo de Calificación Cinematográfica (Chile) của video. Các giá trị hợp lệ của cơ sở lưu trú này là: ccc14 – 14 tuổi trở lên ccc18 – 18 tuổi trở lên ccc18s – 18+ - contenido pornográfico ccc18v – 18+ – contenido exceivamente oro ccc6 – 6+ – Bất tiện cho nam giới 7 años cccTe – Đối tượng công việc cccUnrated
contentDetails.contentRating.cceRating	string Điểm xếp hạng của video từ cơ quan Co missão de Classificação de Espect ́culos của Bồ Đào Nha. Các giá trị hợp lệ của cơ sở lưu trú này là: cceM12 – 12 cceM14 – 14 cceM16 – 16 tuổi cceM18 – 18 tuổi cceM4 – 4 người cceM6 – 6 cceUnrated
contentDetails.contentRating.chfilmRating	string Điểm xếp hạng của video ở Thuỵ Sĩ. Các giá trị hợp lệ của cơ sở lưu trú này là: chfilm0 – 0 chfilm12 – 12 chfilm16 – 16 tuổi chfilm18 – 18 tuổi chfilm6 – 6 chfilmUnrated
contentDetails.contentRating.chvrsRating	string Điểm xếp hạng của Hệ thống phân loại video gia đình (CHVRS) tại Canada đối với video đó. Các giá trị hợp lệ của thuộc tính này là: chvrs14a – 14A chvrs18a – 18 giờ chvrsE – E chvrsG – G chvrsPg – PG chvrsR – Phải chvrsUnrated
contentDetails.contentRating.cicfRating	string Mức phân loại video do Commission de Contrôle des Movies (Bỉ). Các giá trị hợp lệ của cơ sở lưu trú này là: cicfE – E cicfKntEna – KNT/ENA cicfKtEa – KT/EA cicfUnrated
contentDetails.contentRating.cnaRating	string Điểm xếp hạng của video là từ tổ chức CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) của Romania. Các giá trị hợp lệ của thuộc tính này là: cna12 – 12 cna15 – 15 cna18 – 18 tuổi cna18plus – 18 tuổi trở lên cnaAp – AP cnaUnrated
contentDetails.contentRating.cncRating	string Hệ thống phân loại tại Pháp – Uỷ ban phân loại điện ảnh Các giá trị hợp lệ của cơ sở lưu trú này là: cnc10 – 10 cnc12 – 12 cnc16 – 16 tuổi cnc18 – 18 tuổi cncE – E cncT – T3 cncUnrated
contentDetails.contentRating.csaRating	string Cơ quan phân loại video của Conseil supérieur de l?audiovisuel (Pháp) công bố mức phân loại nội dung phát sóng. Các giá trị hợp lệ của thuộc tính này là: csa10 – 10 csa12 – 12 csa16 – 16 tuổi csa18 – 18 tuổi csaInterdiction – Ngăn chặn csaT – T3 csaUnrated
contentDetails.contentRating.cscfRating	string Điểm xếp hạng video của Uỷ ban giám sát và phân loại phim (CSCF) của Luxembourg. Các giá trị hợp lệ của thuộc tính này là: cscf12 – 12 cscf16 – 16 tuổi cscf18 – 18 tuổi cscf6 – 6 cscf9 – 9 người cscfA – A cscfAl – AL cscfUnrated
contentDetails.contentRating.czfilmRating	string Điểm xếp hạng của video tại Cộng hòa Séc. Các giá trị hợp lệ của cơ sở lưu trú này là: czfilm12 – 12 czfilm14 – 14 czfilm18 – 18 tuổi czfilmU – U czfilmUnrated
contentDetails.contentRating.djctqRating	string Điểm xếp hạng của video là Con Cenation, Classificação, Qualificação e Títulos (DJCQT – Brazil). Các giá trị hợp lệ của cơ sở lưu trú này là: djctq10 – 10 djctq12 – 12 djctq14 – 14 djctq16 – 16 tuổi djctq18 – 18 tuổi djctqL – Thấp djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list Lý do giải thích vì sao video đó có mức phân loại là DJCQT (Brazil).
contentDetails.contentRating.ecbmctRating	string Hệ thống phân loại ở Thổ Nhĩ Kỳ – Uỷ ban đánh giá và phân loại thuộc Bộ Văn hoá và Du lịch Các giá trị hợp lệ của cơ sở lưu trú này là: ecbmct13a – 13A ecbmct13plus – 13 tuổi trở lên ecbmct15a – 15A ecbmct15plus – 15 tuổi trở lên ecbmct18plus – 18 tuổi trở lên ecbmct7a – 7A ecbmct7plus – 7 trở lên ecbmctG – G ecbmctUnrated ecbmct6a – 6A ecbmct6plus – 6 tuổi trở lên ecbmct10a – 10A ecbmct10plus – 10 tuổi trở lên ecbmct16plus – 16 tuổi trở lên
contentDetails.contentRating.eefilmRating	string Điểm xếp hạng của video này tại Estonia. Các giá trị hợp lệ của cơ sở lưu trú này là: eefilmK12 – K-12 eefilmK14 – K-14 eefilmK16 – K-16 eefilmK6 – K-6 eefilmL – Thấp eefilmMs12 – MS-12 eefilmMs6 – MS-6 eefilmPere – Pere eefilmUnrated
contentDetails.contentRating.egfilmRating	string Điểm xếp hạng của video ở Ai Cập. Các giá trị hợp lệ của cơ sở lưu trú này là: egfilm18 – 18 tuổi egfilmBn – BN egfilmGn – GN (Guinea) egfilmUnrated
contentDetails.contentRating.eirinRating	string Điểm xếp hạng 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ệ của cơ sở lưu trú này là: eirinG – G eirinPg12 – PG-12 eirinR15plus – R15 trở lên eirinR18plus – R18 trở lên eirinUnrated
contentDetails.contentRating.fcbmRating	string Xếp hạng video của Hội đồng kiểm duyệt phim của Malaysia. Các giá trị hợp lệ của cơ sở lưu trú này là: fcbm13 – 13 fcbm16 – 16 tuổi fcbm18 – 18 tuổi fcbm18pa – 18PA fcbm18pl – 18PL fcbm18sg – 18 SGD fcbm18sx – 18SX fcbmP12 – P12 fcbmP13 – P13 fcbmPg13 – PG13 fcbmU – U fcbmUnrated
contentDetails.contentRating.fcoRating	string Điểm xếp hạng của video do Văn phòng Phim, Báo và Bài viết Hong Kong đưa ra. Các giá trị hợp lệ của cơ sở lưu trú này là: fcoI – Tôi fcoIi – II fcoIia – IIA fcoIib – IIB fcoIii – III fcoUnrated
contentDetails.contentRating.fmocRating	string Thuộc tính này không đượ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. Phân loại video của Trung tâm quốc gia du cinéma et de l'image animé (Bộ Văn hoá Pháp). Các giá trị hợp lệ của cơ sở lưu trú này là: fmoc10 – 10 fmoc12 – 12 fmoc16 – 16 tuổi fmoc18 – 18 tuổi fmocE – E fmocU – U fmocUnrated
contentDetails.contentRating.fpbRating	string Mức phân loại video của Hội đồng Phim và Ấn phẩm Nam Phi. Các giá trị hợp lệ của thuộc tính này là: fpb10 – 10 fpb1012Pg – 10 – 12 PG fpb13 – 13 fpb16 – 16 tuổi fpb18 – 18 tuổi fpb79Pg – 7 – 9 PG fpbA – A fpbPg – PG fpbUnrated fpbX18 – X18 fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[]	list Lý do giải thích lý do video nhận được mức phân loại FPB (Nam Phi).
contentDetails.contentRating.fskRating	string Điểm xếp hạng của FreiWillige Selbstkontrolle der Filmwirtschaft (FSK – Đức) của video. Các giá trị hợp lệ của cơ sở lưu trú này là: fsk0 – FSK 0 fsk12 – FSK 12 fsk16 – 16 FSK fsk18 – 18 FSK fsk6 – FSK 6 fskUnrated
contentDetails.contentRating.grfilmRating	string Điểm xếp hạng của video này tại Hy Lạp. Các giá trị hợp lệ của cơ sở lưu trú này là: grfilmE – E grfilmK – K grfilmK12 – K-12 grfilmK13 – K-13 grfilmK15 – K-15 grfilmK17 – K-17 grfilmK18 – K-18 grfilmUnrated
contentDetails.contentRating.icaaRating	string Điểm xếp hạng của Instituto de la Cinematografía y de las Artes AudioVisuales (ICAA – Tây Ban Nha) đối với video. Các giá trị hợp lệ của cơ sở lưu trú này là: icaa12 – 12 icaa13 – 13 icaa16 – 16 tuổi icaa18 – 18 tuổi icaa7 – 7 icaaApta – APTA icaaUnrated icaaX – X
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. Hãy xem trang web của IFCO để biết thêm thông tin. Các giá trị hợp lệ của thuộc tính này là: ifco12 – 12 ifco12a – 12A ifco15 – 15 ifco15a – 15A ifco16 – 16 tuổi ifco18 – 18 tuổi ifcoG – G ifcoPg – PG ifcoUnrated
contentDetails.contentRating.ilfilmRating	string Điểm xếp hạng của video đó ở Israel. Các giá trị hợp lệ của cơ sở lưu trú này là: ilfilm12 – 12 ilfilm16 – 16 tuổi ilfilm18 – 18 tuổi ilfilmAa – AA ilfilmUnrated
contentDetails.contentRating.incaaRating	string Mức phân loại theo Hiệp hội Quốc gia (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à: incaaAtp – ATP (Apta para todo publico) incaaC – X (Solo apta para mayores de 18 años, de exhibición condicionada) incaaSam13 – 13 (Solo apta para mayores de 13 años) incaaSam16 – 16 (Solo apta para mayores de 16 años) incaaSam18 – 18 (Solo apta para mayores de 18 años) incaaUnrated
contentDetails.contentRating.kfcbRating	string Mức phân loại video của Uỷ ban phân loại phim Kenya. Các giá trị hợp lệ của thuộc tính này là: kfcb16plus – 16 tuổi kfcbG – GE kfcbPg – PG kfcbR – 18 tuổi kfcbUnrated
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à: kijkwijzer12 – 12 kijkwijzer14 – 14 kijkwijzer16 – 16 tuổi kijkwijzer18 – 18 tuổi kijkwijzer6 – 6 kijkwijzer9 – 9 người kijkwijzerAl – AL kijkwijzerUnrated
contentDetails.contentRating.kmrbRating	string Mức phân loại của Hội đồng phân loại nội dung truyền thông Hàn Quốc (sftp상물QUÁ 급알tài LED). KMRB phân loại các video ở Hàn Quốc. Các giá trị hợp lệ của cơ sở lưu trú này là: kmrb12plus – 12세 이상 관람아 kmrb15plus – 15세 이상 관람리 kmrbAll – 선츴관람니 năng kmrbR – 청소년 관람불ID kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string Điểm xếp hạng của video là từ hãng phim Lembaga Sensor Film (Indonesia). Các giá trị hợp lệ của thuộc tính này là: lsf13 – 13 lsf17 – 17 lsf21 – 21 lsfA – A lsfBo – BO (Bolivia) lsfD – D lsfR – Phải lsfSu – SU lsfUnrated
contentDetails.contentRating.mccaaRating	string Mức phân loại video của Hội đồng phân loại độ tuổi phim ảnh của Malta. Các giá trị hợp lệ của thuộc tính này là: mccaa12 – 12 mccaa12a – 12A mccaa14 – 14 – điểm xếp hạng này đã bị gỡ bỏ khỏi cấu trúc phân loại mới được ra mắt vào năm 2013. mccaa15 – 15 mccaa16 – 16 – mức phân loại này đã bị gỡ bỏ khỏi cấu trúc phân loại mới được ra mắt vào năm 2013. mccaa18 – 18 tuổi mccaaPg – PG mccaaU – U mccaaUnrated
contentDetails.contentRating.mccypRating	string Điểm xếp hạng của video do Hội đồng truyền thông dành cho trẻ em và thanh thiếu niên (Det Danske Filminstitut) của Viện Điện ảnh Đan Mạch (Det Danske Filminstitut). Giá trị hợp lệ của thuộc tính này là: mccyp11 – 11 mccyp15 – 15 mccyp7 – 7 mccypA – A mccypUnrated
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ệ của cơ sở lưu trú này là: mcst0 – 0 mcst16plus – 16 tuổi trở lên mcstC13 – C13 mcstC16 – C16 mcstC18 – C18 mcstP – P mcstUnrated mcstT13 – T13 mcstT16 – T16 mcstT18 – T18 mcstK – K
contentDetails.contentRating.mdaRating	string Mức phân loại của video đó là của Cơ quan Phát triển Truyền thông (MDA) Singapore và cụ thể là Hội đồng kiểm duyệt phim (BFC). Các giá trị hợp lệ của tài sản này là: mdaG – G mdaM18 – M18 mdaNc16 – NC16 mdaPg – PG mdaPg13 – PG13 mdaR21 – R21 mdaUnrated
contentDetails.contentRating.medietilsynetRating	string Điểm xếp hạng video của Medietilsynet (Cơ quan quản lý truyền thông Na Uy). Các giá trị hợp lệ của tài sản này là: medietilsynet11 – 11 medietilsynet12 – 12 medietilsynet15 – 15 medietilsynet18 – 18 tuổi medietilsynet6 – 6 medietilsynet7 – 7 medietilsynet9 – 9 người medietilsynetA – A medietilsynetUnrated
contentDetails.contentRating.mekuRating	string Xếp hạng của video từ Viện Kansallinen Audiovisuaalinen Instituutti (Viện nghe nhìn Quốc gia) của Phần Lan. Các giá trị hợp lệ của cơ sở lưu trú này là: meku12 – 12 meku16 – 16 tuổi meku18 – 18 tuổi meku7 – 7 mekuS – Nam mekuUnrated
contentDetails.contentRating.mibacRating	string Điểm xếp hạng video từ Ministero dei Beni e delle Attività Culturali e del Turismo (Ý). Các giá trị hợp lệ của cơ sở lưu trú này là: mibacT mibacUnrated mibacVap mibacVm6 mibacVm12 mibacVm14 mibacVm18
contentDetails.contentRating.mocRating	string Điểm xếp hạng của video có tên là Ministerio de Cultura (Colombia). Các giá trị hợp lệ của cơ sở lưu trú này là: moc12 – 12 moc15 – 15 moc18 – 18 tuổi moc7 – 7 mocBanned – Bị cấm mocE – E mocT – T3 mocUnrated mocX – X
contentDetails.contentRating.moctwRating	string Mức phân loại của video do Bộ Văn hoá Đài Loan (文化部) đánh giá. Các giá trị hợp lệ của thuộc tính này là: moctwG – G moctwP – P moctwPg – PG moctwR – Phải moctwR12 – R-12 moctwR15 – R-15 moctwUnrated
contentDetails.contentRating.mpaaRating	string Mứ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ệ của tài sản này là: mpaaG – G mpaaNc17 – NC-17 mpaaPg – PG mpaaPg13 – PG-13 mpaaR – Phải mpaaUnrated
contentDetails.contentRating.mpaatRating	string Xếp hạng của Hiệp hội Điện ảnh Hoa Kỳ về đoạn giới thiệu và bản xem trước phim. Các giá trị hợp lệ của thuộc tính này là: mpaatGb – GB (Băng tần màu xanh lục – Được phê duyệt cho mọi đối tượng) mpaatRb – RB (Dây đeo màu đỏ – Dành cho độ tuổi từ 17 trở lên)
contentDetails.contentRating.mtrcbRating	string Mức phân loại video của Uỷ ban phân loại và đánh giá phim và chương trình truyền hình (Philippines). Các giá trị hợp lệ của tài sản này là: mtrcbG – G mtrcbPg – PG mtrcbR13 – R-13 mtrcbR16 – R-16 mtrcbR18 – R-18 mtrcbUnrated mtrcbX – X
contentDetails.contentRating.nbcRating	string Mức phân loại video của Cục phân loại quốc gia Maldives. Các giá trị hợp lệ của thuộc tính này là: nbc12plus – 12 tuổi trở lên nbc15plus – 15 tuổi trở lên nbc18plus – 18 tuổi trở lên nbc18plusr – 18 tuổi trở lên nbcG – G nbcPg – PG nbcPu – PU nbcUnrated
contentDetails.contentRating.nfrcRating	string Mức phân loại của video đó từ Trung tâm phim ảnh quốc gia Bulgaria. Các giá trị hợp lệ của cơ sở lưu trú này là: nfrcA – A nfrcB – TỶ nfrcC – C nfrcD – D nfrcUnrated nfrcX – X
contentDetails.contentRating.nfvcbRating	string Điểm xếp hạng video của Hội đồng kiểm duyệt phim và video quốc gia Nigeria. Các giá trị hợp lệ của cơ sở lưu trú này là: nfvcb12 – 12 nfvcb12a – 12A nfvcb15 – 15 nfvcb18 – 18 tuổi nfvcbG – G nfvcbPg – PG nfvcbRe – RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string Điểm xếp hạng của video là lấy từ Nacionãlais Kino centrs (Trung tâm Phim ảnh Quốc gia Latvia). Các giá trị hợp lệ của cơ sở lưu trú này là: nkclv12plus – 12 tuổi trở lên nkclv18plus – 18 tuổi trở lên nkclv7plus – 7 trở lên nkclvU – U nkclvUnrated
contentDetails.contentRating.oflcRating	string Mức phân loại của Văn phòng phân loại phim và văn học (OFLC – New Zealand) đối với video. Các giá trị hợp lệ của thuộc tính này là: oflcG – G oflcM – 3 oflcPg – PG oflcR13 – R13 oflcR15 – R15 oflcR16 – R16 oflcR18 – R18 oflcRp13 – RP13 oflcRp16 – RP16 oflcUnrated
contentDetails.contentRating.pefilmRating	string Điểm xếp hạng của video tại Peru. Các giá trị hợp lệ của cơ sở lưu trú này là: pefilm14 – 14 pefilm18 – 18 tuổi pefilmPg – PG pefilmPt – Tiếng Bồ Đào Nha pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating	string Điểm xếp hạng của video tại Venezuela. Các giá trị hợp lệ của cơ sở lưu trú này là: resorteviolenciaA – A resorteviolenciaB – TỶ resorteviolenciaC – C resorteviolenciaD – D resorteviolenciaE – E resorteviolenciaUnrated
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) của video. Các giá trị hợp lệ của thuộc tính này là: rtcA – A rtcAa – AA rtcB – TỶ rtcB15 – B15 rtcC – C rtcD – D rtcUnrated
contentDetails.contentRating.rteRating	string Điểm xếp hạng video từ Raidió Teilifís Éireann (Ireland). Các giá trị hợp lệ của cơ sở lưu trú này là: rteCh – Thuỵ Sĩ rteGa – SBT rteMa – MA rtePs – PS rteUnrated
contentDetails.contentRating.russiaRating	string Mức phân loại đối với video đó của Cơ quan đăng ký phim quốc gia của Liên bang Nga (MKRF – Nga). Các giá trị hợp lệ của cơ sở lưu trú này là: russia0 – 0 trở lên russia12 – 12 tuổi trở lên russia16 – 16 tuổi trở lên russia18 – 18 tuổi trở lên russia6 – 6 tuổi trở lên russiaUnrated
contentDetails.contentRating.skfilmRating	string Điểm xếp hạng của video này tại Slovakia. Các giá trị hợp lệ của cơ sở lưu trú này là: skfilmG – G skfilmP2 – P2 skfilmP5 – P5 skfilmP8 – P8 skfilmUnrated
contentDetails.contentRating.smaisRating	string Điểm xếp hạng của video tại Iceland. Các giá trị hợp lệ của cơ sở lưu trú này là: smais12 – 12 smais14 – 14 smais16 – 16 tuổi smais18 – 18 tuổi smais7 – 7 smaisL – Thấp smaisUnrated
contentDetails.contentRating.smsaRating	string Điểm xếp hạng video do Statens medier nữad (Hội đồng truyền thông quốc gia Thuỵ Điển) đưa ra. Các giá trị hợp lệ của tài sản này là: smsa11 – 11 smsa15 – 15 smsa7 – 7 smsaA – Tất cả độ tuổi smsaUnrated
contentDetails.contentRating.tvpgRating	string Mức phân loại theo Nguyên tắc dành cho cha mẹ đối với chương trình truyền hình (TVPG) của video. Các giá trị hợp lệ của tài sản này là: tvpgG – TV-G tvpgMa – TV-MA tvpgPg – TV-PG tvpgUnrated tvpgY – TV-Y tvpgY7 – TV-Y7 tvpgY7Fv – TV-Y7-FV pg14 – TV-14
contentDetails.contentRating.ytRating	string Mứ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ệ của tài sản này là: ytAgeRestricted
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à: 360 rectangular
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 xem được tài sản 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ệ của tài sản này là: deleted failed processed rejected uploaded
status.failureReason	string Giá trị này giải thích lý do không thể tải video lên. Tài sản này chỉ xuất hiện nếu tài sản uploadStatus cho biết rằng quá trình tải lên không thành công. Các giá trị hợp lệ của tài sản này là: codec conversion emptyFile invalidFile tooSmall uploadAborted
status.rejectionReason	string Giá trị này giải thích lý do YouTube từ chối một video đã tải lên. Tài sản này chỉ xuất hiện nếu tài sản uploadStatus cho biết tệp tải lên đã bị từ chối. Các giá trị hợp lệ của tài sản này là: claim copyright duplicate inappropriate legal length termsOfUse trademark uploaderAccountClosed uploaderAccountSuspended
status.privacyStatus	string Trạng thái quyền riêng tư của video. Các giá trị hợp lệ của tài sản này là: private public unlisted
status.publishAt	datetime Ngày và giờ mà bạn đã lên lịch xuất bản video. Bạn chỉ có thể đặt chế độ này khi video ở trạng thái riêng tư. Giá trị được chỉ định theo định dạng ISO 8601. Xin lưu ý hai điểm bổ sung sau đây về hành vi của thuộc tính này: Nếu đặt giá trị của thuộc tính này khi gọi phương thức videos.update, bạn cũng phải đặt giá trị thuộc tính status.privacyStatus thành private ngay cả khi video đã ở chế độ riêng tư. Nếu yêu cầu của bạn lên lịch xuất bản video tại một thời điểm nào đó trong quá khứ, thì video đó sẽ được xuất bản ngay lập tức. Do đó, việc đặt thuộc tính status.publishAt thành một ngày và giờ trong quá khứ cũng giống như việc thay đổi privacyStatus của video từ private thành public.
status.license	string Giấy phép của video. Các giá trị hợp lệ của tài sản này là: creativeCommon youtube
status.embeddable	boolean Giá trị này cho biết video có thể nhúng được 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 về video trên trang xem của video có xem được công khai hay không. Theo mặc định, bạn có thể xem các số liệu thống kê đó và các số liệu thống kê như số lượt xem và điểm xếp hạng của video sẽ vẫn hiển thị công khai ngay cả khi giá trị của tài sản này được đặt thành false.
status.madeForKids	boolean Giá trị này cho biết liệu video có được chỉ định là hướng tới trẻ em hay không, đồng thời cũng có trạng thái hiện tại là "dành cho trẻ em" 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 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 của bạn.
status.selfDeclaredMadeForKids	boolean Trong yêu cầu videos.insert hoặc videos.update, tài sản này cho phép chủ sở hữu kênh chỉ định video là 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 đã uỷ quyền yêu cầu API.
statistics	object Đối tượng statistics chứa số liệu thống kê về video.
statistics.viewCount	unsigned long Số lần video được xem.
statistics.likeCount	unsigned long Số người dùng đã cho biết họ thích video đó.
statistics.dislikeCount	unsigned long Lưu ý: Kể từ ngày 13 tháng 12 năm 2021, tài sản statistics.dislikeCount đã được đặt ở chế độ riêng tư. Điều này có nghĩa là thuộc tính 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 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 này có hiệu lực kể từ ngày 28 tháng 8 năm 2015. Giá trị của thuộc tính hiện luôn được đặt thành 0.
statistics.commentCount	unsigned long Số bình luận của video.
player	object Đối tượng player chứa thông tin mà bạn sẽ dùng để phát video trong một trình phát được nhúng.
player.embedHtml	string Thẻ <iframe> nhúng trình phát phát video. Nếu yêu cầu API để truy xuất tài nguyên chỉ định một giá trị cho tham số maxHeight và/hoặc maxWidth, thì kích thước của trình phát được nhúng sẽ được điều chỉnh theo tỷ lệ để đáp ứng các yêu cầu của maxHeight và/hoặc maxWidth. Nếu tỷ lệ khung hình của video không xác định thì trình phát được nhúng sẽ mặc định ở định dạng 4:3.
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 tham số maxHeight và/hoặc maxWidth và xác định được tỷ lệ khung hình của video.
topicDetails	object Đối tượng topicDetails đóng gói thông tin về các chủ đề liên kết với 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 về những thay đổi sắp tới liên quan đến mã chủ đề.
topicDetails.topicIds[]	list Lưu ý quan trọng: Tài sản 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 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. Thuộc tính này đã ngừng hoạt động kể từ ngày 10 tháng 11 năm 2016. Chúng tôi sẽ hỗ trợ tính năng này cho đến hết ngày 10 tháng 11 năm 2017. Lưu ý quan trọng: Do Freebase và API Freebase ngừng hoạt động, 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 tập hợp nhỏ mã chủ đề được tuyển chọn. Xem các mã chủ đề được hỗ trợ kể từ ngày 15 tháng 2 năm 2017 Chủ đề Chủ đề âm nhạc /m/04rlf Âm nhạc (chủ đề gốc) /m/02mscn nhạc Cơ Đốc /m/0ggq0m Nhạc cổ điển /m/01lyv Quốc gia /m/02lkt Nhạc điện tử /m/0glt670 Nhạc hip hop /m/05rwpb Âm nhạc độc lập /m/03_d0 Nhạc Jazz /m/028sqc Âm nhạc Châu Á /m/0g293 Âm nhạc Mỹ Latinh /m/064t9 Nhạc Pop /m/06cqb Nhạc Reggae /m/06j6l Nhịp điệu và nhạc Blues /m/06by7 Nhạc rock /m/0gywn Nhạc Soul Chủ đề trò chơi /m/0bzvm2 Trò chơi (chủ đề mẹ) /m/025zzc Trò chơi hành động /m/02ntfj Trò chơi hành động phiêu lưu /m/0b1vjn Trò chơi phổ thông /m/02hygl Trò chơi điện tử âm nhạc /m/04q1x3q Trò chơi điện tử giải đố /m/01sjng Trò chơi điện tử đua xe /m/0403l3g Trò chơi điện tử nhập vai /m/021bp2 Trò chơi điện tử mô phỏng /m/022dc6 Trò chơi thể thao /m/03hf_rm Trò chơi điện tử chiến lược Chủ đề thể thao /m/06ntj Thể thao (chủ đề mẹ) /m/0jm_ Bóng bầu dục Mỹ /m/018jz Bóng chày /m/018w8 Bóng rổ /m/01cgz Quyền anh /m/09xp_ Bóng gậy /m/02vx4 Bóng đá /m/037hz Sân gôn /m/03tmr Khúc côn cầu trên băng /m/01h7lh Võ tổng hợp /m/0410tth Đua mô tô /m/07bs0 Quần vợt /m/07_53 Bóng chuyền Chủ đề giải trí /m/02jjt Giải trí (chủ đề mẹ) /m/09kqc Hài hước /m/02vxn Phim /m/05qjc Nội dung nghệ thuật biểu diễn /m/066wd Đấu vật chuyên nghiệp /m/0f2f9 Chương trình truyền hình Chủ đề về lối sống /m/019_rr Lối sống (chủ đề của cha mẹ) /m/032tl Thời trang /m/027x7n Thể dục /m/02wbm Ẩm thực /m/03glg Sở thích /m/068hy Thú cưng /m/041xxh Sự hấp dẫn về hình thể [Sắc đẹp] /m/07c1v Công nghệ /m/07bxq Du lịch /m/07yv9 Phương tiện vận tải Chủ đề về xã hội /m/098wr Xã hội (chủ đề gốc) /m/09s1f Kinh doanh /m/0kt51 Sức khỏe /m/01h6rj Quân đội /m/05qt0 Chính trị /m/06bvp Tôn giáo Chủ đề khác /m/01k8wb Tri thức
topicDetails.topicCategories[]	list Danh sách các URL trên Wikipedia cung cấp thông tin mô tả tổng quan về nội dung video.
recordingDetails	object Đối tượng recordingDetails đóng gói thông tin về địa điểm, ngày và địa chỉ quay video.
recordingDetails.locationDescription	string 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 ngừng cung cấp để biết thêm chi tiết. Nội dung mô tả dạng văn bản về địa điểm quay video.
recordingDetails.location	object Thông tin về vị trí địa lý của video. Lưu ý rằng 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. Giá trị này có thể chỉnh sửa, tìm kiếm được trên video công khai và 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 ngừng cung cấp để biết thêm chi tiết. Vĩ độ tính theo độ.
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 ngừng cung cấp để biết thêm chi tiết. Kinh độ tính theo độ.
recordingDetails.location.altitude	double Tài sản này không đượ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 cung cấp để biết thêm chi tiết. Độ cao so với hình elipsoid tham chiếu, tính bằng mét.
recordingDetails.recordingDate	datetime Ngày và giờ quay video. Giá trị được chỉ định theo đị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 được 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, video, tốc độ bit của luồng và các 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ị available.
fileDetails.fileName	string Tên của tệp đã tải lên. Trường này xuất hiện để cho biết tệp video hay loại tệp khác đã được tải 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 xuất hiện để cho biết tệp video hay loại tệp khác đã được tải lên.
fileDetails.fileType	string Loạ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 hay chưa. Các giá trị hợp lệ cho thuộc tính này là: archive – Tệp này là một tệp lưu trữ, chẳng hạn như tệp lưu trữ .zip. audio – Tệp thuộc loại tệp âm thanh đã biết, chẳng hạn như tệp .mp3. document – Tệp là một tài liệu hoặc tệp văn bản, chẳng hạn như tài liệu MS Word. image – Tệp là một tệp hình ảnh, chẳng hạn như hình ảnh .jpeg. other – Tệp này là một loại tệp khác không phải video. project – Tệp là tệp dự án video, chẳng hạn như dự án Microsoft Windows Movie Maker không chứa dữ liệu video thực. video – Tệp thuộc loại tệp video đã biết, chẳng hạn như tệp .mp4.
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 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 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 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, xác định tỷ lệ khung hình mà video sẽ 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/giây.
fileDetails.videoStreams[].rotation	string Thời lượng mà YouTube cần để xoay vòng 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à: clockwise – Video cần được xoay 90 độ theo chiều kim đồng hồ. counterClockwise – Video cần được xoay 90 độ ngược chiều kim đồng hồ. none – Không cần xoay video. other – Bạn cần xoay video theo một cách không đơn giản. upsideDown – Video cần được xoay ngược.
fileDetails.videoStreams[].vendor	string Giá trị xác định duy nhất một nhà cung cấp video. Thông thường, giá trị sẽ là mã nhà cung cấp gồm bốn 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 đều chứa siêu dữ liệu chi tiết về một luồng âm thanh.
fileDetails.audioStreams[].channelCount	unsigned integer Số kênh âm thanh có trong luồng đó.
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/giây.
fileDetails.audioStreams[].vendor	string Giá trị xác định duy nhất một nhà cung cấp video. Thông thường, giá trị sẽ là mã nhà cung cấp gồm bốn 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/giây.
fileDetails.creationTime	string Ngày và giờ tạo tệp video tải lên. Giá trị được chỉ định theo định dạng ISO 8601. Hiện tại, chúng tôi hỗ trợ các định dạng ISO 8601 sau: Chỉ ngày: YYYY-MM-DD Thời gian ban đầu: YYYY-MM-DDTHH:MM:SS Thời gian có múi giờ: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails	object Đối tượng processingDetails đóng gói thông tin về tiến trình của YouTube trong quá trình 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à ước tính thời gian còn lại cho đến khi YouTube xử lý xong 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ư chi tiết tệp hoặc hình ảnh thu nhỏ, có sẵn cho video hay không. Đối tượng processingProgress được thiết kế để thăm dò ý kiến, sao cho video 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 được 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 YouTube có thể xử lý video hay không hoặc video có đang được xử lý hay không. Các giá trị hợp lệ cho thuộc tính này là: failed – Xử lý video không thành công. Xem ProcessFailureReason. processing – Video đang được xử lý. Xem Tiến trình xử lý. succeeded – Video đã được xử lý thành công. terminated – Thông tin đang xử lý không còn nữa.
processingDetails.processingProgress	object Đối tượng processingProgress chứa thông tin về tiến trình YouTube đã thực hiện trong quá trình xử lý video. 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 long Chỉ số ước tính tổng số phần cần xử lý cho video. Con số này có thể được cập nhật với 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 toán: 100 * parts_processed / parts_total Xin lưu ý rằng vì số phần ước tính có thể tăng nhưng số phần đã xử lý không tăng tương ứng, nên tiến trình được tính toán có thể giảm định kỳ trong khi YouTube xử lý video.
processingDetails.processingProgress.timeLeftMs	unsigned long Chỉ số ước tính thời gian (tính bằng mili giây) mà YouTube cần để xử lý xong 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à: other – Một số thành phần xử lý khác không thành công. streamingFailed – Không gửi được video đến người phát trực tiếp. transcodeFailed – Chuyển mã nội dung không thành công. uploadFailed – Không gửi được tệp.
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 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 các nội dung đề xuất có thể cải thiện khả năng xử lý video của YouTube hay không, các cảnh báo giải thích vấn đề khi xử lý video hay lỗi gây ra sự cố khi xử lý 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.tagSuggestionsAvailability	string Giá trị này cho biết liệu có các đề xuất về 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 tìm thấy video dễ dàng hơn. 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	string Giá trị này cho biết liệu các đề xuất chỉnh sửa video (có thể giúp cải thiện chất lượng video hoặc trải nghiệm phát) cho 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.thumbnailsAvailability	string Giá trị này cho biết liệu hình thu nhỏ đã được tạo cho video hay chưa.
suggestions	object Đối tượng suggestions đóng gói các nội dung đề 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ị 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 ra sao, sau cùng thì trạng thái đó gần như chắc chắn sẽ là failed. Các giá trị hợp lệ của tài sản này là: archiveFile – Tệp lưu trữ (ví dụ: tệp lưu trữ ZIP). audioFile – Tệp chỉ chứa âm thanh (ví dụ: tệp MP3). docFile – Tài liệu hoặc tệp văn bản (ví dụ: Tài liệu MS Word). imageFile – Tệp hình ảnh (ví dụ: hình ảnh JPEG). notAVideoFile – Tệp khác không phải video. projectFile – Tệp dự án phim (ví dụ: dự án Microsoft Windows Movie Maker).
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 được tải lên hoặc dẫn đến việc chuyển mã lỗi. 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, hệ thống này xác định những sự cố không nhất thiết cho biết rằng quá trình xử lý video sẽ không thành công nhưng vẫn có thể gây ra các sự cố, chẳng hạn như sự cố đồng bộ hoá, cấu phần phần mềm video hoặc bản âm thanh bị thiếu. Các giá trị hợp lệ cho thuộc tính này là: hasEditlist – Tính năng chỉnh sửa danh sách hiện không được hỗ trợ. inconsistentResolution – Xung đột giữa các giải pháp vùng chứa và luồng. problematicAudioCodec – Bộ mã hoá và giải mã âm thanh được xác định là gây ra sự cố đã được sử dụng. problematicVideoCodec – Bộ mã hoá và giải mã video được xác định là gây ra sự cố đã được sử dụng. unknownAudioCodec – Bộ mã hoá và giải mã âm thanh không được nhận dạng, quá trình chuyển mã có thể không thành công. unknownContainer – Định dạng tệp không được nhận dạng, quá trình chuyển mã có thể không thành công. unknownVideoCodec – Bộ mã hoá và giải mã video không được nhận dạng, quá trình chuyển mã có thể không thành công.
suggestions.processingHints[]	list Danh sách các đề xuất có thể giúp 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à: nonStreamableMov – Không thể phát trực tuyến tệp MP4, việc này sẽ làm chậm quá trình xử lý. sendBestQualityVideo – Có thể phiên bản video có chất lượng tốt hơn.
suggestions.tagSuggestions[]	list Danh sách 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 sẽ 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 Tập hợp các danh mục video mà thẻ có liên quan. Bạn có thể sử dụng thông tin này để hiển thị các đề xuất thẻ thích hợp dựa trên danh mục video mà người tải lên video liên kết với video. Theo mặc định, các đề xuất thẻ có liên quan đến tất cả danh mục nếu không có giới hạn nào được xác định cho từ khoá.
suggestions.editorSuggestions[]	list Danh 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 của video tải lên. Các giá trị hợp lệ của tài sản này là: audioQuietAudioSwap – Bản âm thanh có vẻ im lặng và có thể được hoán đổi bằng bản âm thanh có chất lượng tốt hơn. videoAutoLevels – Mức độ sáng của hình ảnh dường như bị tắt và có thể chỉnh sửa. videoCrop – Lề (mờ) xung quanh ảnh có thể bị cắt. videoStabilize – Video có vẻ bị rung và có thể ổn định.
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 chương trình phát sóng trực tiếp sắp diễn ra, đang phát sóng hoặc đã kết thúc.
liveStreamingDetails.actualStartTime	datetime Thời điểm sự kiện phát sóng thực sự bắt đầu. Giá trị được chỉ định theo định dạng ISO 8601. Giá trị này sẽ không có sẵn cho đến khi chương trình phát sóng bắt đầu.
liveStreamingDetails.actualEndTime	datetime Thời lượng sự kiện phát sóng thực sự kết thúc. Giá trị được chỉ định theo định dạng ISO 8601. Giá trị này sẽ không có sẵn cho đến khi chương trình phát sóng kết thúc.
liveStreamingDetails.scheduledStartTime	datetime Thời gian bắt đầu chương trình phát sóng theo lịch. Giá trị được chỉ định theo định dạng ISO 8601.
liveStreamingDetails.scheduledEndTime	datetime Thời gian kết thúc sự kiện phát sóng theo lịch. Giá trị được chỉ định theo định dạng ISO 8601. Nếu giá trị trống hoặc thuộc tính không xuất hiện thì chương trình phát được lên lịch sẽ tiếp tục vô thời hạn.
liveStreamingDetails.concurrentViewers	unsigned long Số người xem hiện tại đang xem chương trình phát sóng. Tài sản và giá trị của tài sản này 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 cho video đó. Xin lưu ý rằng YouTube ngừng theo dõi số lượng người xem đồng thời đối với một sự kiện phát sóng khi sự kiện đó kết thúc. Vì vậy, tài sản này sẽ không xác định được số lượng người xem một 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ố người xem đồng thời mà API Dữ liệu YouTube trả về có thể khác với số người xem đồng thời đã xử lý và đã được 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	string Mã cuộc trò chuyện trực tiếp hiện đang diễn ra được đính kèm với video này. Trường này chỉ được điền nếu video là chương trình phát sóng trực tiếp hiện có cuộc trò chuyện trực tiếp. Sau khi quá trình chuyển đổi chương trình phát sóng hoàn tất, 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 sóng liên tục, mã nhận dạng cuộc trò chuyện trực tiếp sẽ không còn liên kết với video này nữa mà sẽ được liên kết với video mới đang hiện trên trang cố định.
localizations	object Đối tượng localizations chứa các 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á được liên kết với khoá-giá trị. Giá trị là một chuỗi chứa mã ngôn ngữ BCP-47.
localizations.(key).title	string Tiêu đề của video được bản địa hoá.
localizations.(key).description	string Nội dung mô tả video đã bản địa hoá.