Videos

Tất cả video được tải lên thông qua điểm cuối videos.insert từ những 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ỏ hạn chế này, mỗi dự án API phải trải qua một quá trình kiểm tra để xác minh 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.

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

Phương pháp

API 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 tham số yêu cầu API. Thử ngay.

chèn

Tải video lên YouTube và tuỳ chọn cài đặt siêu dữ liệu cho video.

cập nhật

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

xóa

Xoá video trên YouTube. Thử ngay.

giá

Thêm điểm xếp hạng lượt thích hoặc không thích cho một video hoặc xoá điểm xếp hạng khỏi video. Thử ngay.

báo cáo lạm dụng

Báo cáo video chứa nội dung vi phạm. 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 sử dụng để nhận dạng duy nhất video đó.
snippet	object Đối tượng snippet chứa 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 ở dạng video riêng tư và sau đó được công khai sau đó, thuộc tính này sẽ chỉ định thời gian video được công khai. Có một số trường hợp đặc biệt: Nếu video được tải lên dưới dạng video riêng tư và siêu dữ liệu của video do chủ sở hữu kênh truy xuất, thì giá trị thuộc tính sẽ chỉ định ngày và giờ tải video lên. Nếu video được tải lên dưới dạng video không công khai, thì giá trị thuộc tính cũng chỉ định ngày và giờ tải video 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 video. Giá trị này được chỉ định ở định dạng ISO 8601.
snippet.channelId	string Mã nhận dạng mà YouTube sử dụng để nhận dạng riêng 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 mọi 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 Phần mô tả của 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 thu nhỏ và giá trị là đố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 của video hoặc tài nguyên đề cập đến một video (chẳng hạn như một mục trong danh sách phát hoặc kết quả tìm kiếm) có chiều rộng là 120px và chiều cao là 90px. Hình thu nhỏ mặc định của một 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 320px và chiều cao 180px. Đối với một kênh, hình ảnh này rộng 240px và 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 480px và chiều cao 360px. Đối với một kênh, hình ảnh này có chiều rộng 800px và chiều cao 800px. standard – Phiên bản hình thu nhỏ thậm chí còn cao hơn phiên bản hình ảnh có độ phân giải high. Hình ảnh này có sẵn cho một số video và các tài nguyên khác đề cập đế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 640 px và cao 480 px. 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 có sẵn cho một số video và các tài nguyên khác đề cập đến video, 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 có chiều rộng 1280px và chiều 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 các thẻ từ khóa 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ự. Xin 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 giới hạn này. Nếu một thẻ chứa dấu cách, máy chủ API sẽ xử lý giá trị thẻ như thể nó được đặt trong dấu ngoặc kép và dấu ngoặc kép được tính vào giới hạn ký tự. Vì vậy, vì mục đích giới hạn ký tự, thẻ Foo-Baz chứa bảy ký tự, nhưng thẻ Foo Baz lại chứa chín 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à chương trình phát sóng trực tiếp/đang diễn ra hay không. Hoặc đó là "không có" nếu video không phải là chương trình phát trực tiếp sắp tới/đang hoạt động. Giá trị hợp lệ cho thuộc tính 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 hóa của video hoặc tiêu đề trong ngôn ngữ mặc định của siêu dữ liệu video. Văn bản đã bản địa hoá đượ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 một ngôn ngữ mà văn bản đã bản địa hoá sẽ được trả về và văn bản đã bản địa hoá có sẵn bằng ngôn ngữ đó. Siêu dữ liệu cho ngôn ngữ mặc định được trả về nếu giá trị tham số hl chưa được chỉ định hoặc một giá trị được chỉ định nhưng siêu dữ liệu đã được bản địa hoá không có sẵn cho ngôn ngữ được chỉ định. Thuộc tính này 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 tiêu đề đã bản địa hoá.
snippet.localized.title	string Tiêu đề video đã bản địa hoá.
snippet.localized.description	string Thông tin mô tả video đã 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 thời lượng video và cho biết liệu 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 ISO 8601. Ví dụ: đối với video dài ít nhất một phút và ngắn hơn một giờ, thời lượng phải ở định dạng PT#M#S, trong đó chữ cái PT cho biết giá trị chỉ định một khoảng thời gian và các chữ cái M và S lần lượt đề cập đến độ dài 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ị của PT15M33S cho biết video có thời lượng là 15 phút 33 giây. Nếu video dài tối thiểu một giờ, thì thời lượng sẽ ở định dạng PT#H#M#S, trong đó # đứng trước chữ cái H sẽ chỉ định thời lượng của video tính bằng giờ và tất cả chi tiết khác đều giống như mô tả ở trên. Nếu video có thời lượng í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 thông tin đầy đủ.
contentDetails.dimension	string Cho biết video có 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. 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. Giá trị hợp lệ của thuộc tính này là: false true
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 một kênh liên kết với một đối tác nội dung của YouTube rồi do đố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ề quốc gia nơi video (hoặc không thể) xem được. Đối tượng này 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 giúp xác định những quốc gia có thể xem video. Nếu tài sản này có mặt và quốc gia đó không có trong giá trị, thì video sẽ bị chặn 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 này sẽ bị chặn ở tất cả các quốc gia.
contentDetails.regionRestriction.blocked[]	list Danh sách mã khu vực giúp xác định những quốc gia nơi video bị chặn. Nếu có xuất hiện thuộc tính này và một quốc gia không có trong giá trị, thì video có thể xem được ở quốc gia đó. Nếu có tài sản này và chứa một danh sách trống, thì người dùng có thể xem được video ở 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 Bảng phân loại của Úc (ACB) hoặc Cơ quan Truyền thông và Truyền thông Úc (ACMA). Điểm xếp hạng 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 tài sản này là: acbC – Các chương trình đã được cơ quan Truyền thông và Truyền thông Úc phân loại C. Các chương trình này dành cho trẻ em (không phải trẻ mẫu giáo) dưới 14 tuổi. acbE – E acbG – G acbM – M acbMa15plus – MA15 trở lên acbP – Các chương trình đã được cơ quan Truyền thông và Truyền thông Úc phân loại P. Các chương trình này dành cho trẻ em mẫu giáo. acbPg – PG acbR18plus – R18 trở lên acbUnrated
contentDetails.contentRating.agcomRating	string Điểm xếp hạng của video từ Autorità per le Garanzie nelle Comcityazioni (AGCOM) của Ý. Giá trị hợp lệ cho tài sản này là: agcomT đến T agcomUnrated agcomVm14 – VM14 agcomVm18 – VM18
contentDetails.contentRating.anatelRating	string Điểm xếp hạng của video Anatel (Asociación Nacional de Televisión) dành cho truyền hình Chile. Giá trị hợp lệ của cơ sở lưu trú này là: anatelA – A anatelF – F anatelI – I anatelI10 – I-10 anatelI12 – I-12 anatelI7 – I-7 anatelR – R anatelUnrated
contentDetails.contentRating.bbfcRating	string Thứ hạng của Ban phân loại phim (BBFC) tại Anh. Các giá trị hợp lệ cho tài sản này là: bbfc12 đến 12 bbfc12a – 12A bbfc15 đến 15 bbfc18 – 18 bbfcPg – PG bbfcR18 đến R18 bbfcU – U bbfcUnrated
contentDetails.contentRating.bfvcRating	string Điểm đánh giá của video từ Hội đồng kiểm duyệt phim và video của Thái Lan. Giá trị hợp lệ cho tài sản này là: bfvc13 đến 13 bfvc15 đến 15 bfvc18 – 18 bfvc20 đến 20 bfvcB – B 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) cung cấp. Giá trị hợp lệ của tài sản này là: bmukk10 – 10 trở lên bmukk12 – 12 trở lên bmukk14 – 14 trở lên bmukk16 – 16 tuổi trở lên bmukk6 – 6 trở lên bmukk8 – 8 trở lên bmukkAa – Không hạn chế bmukkUnrated
contentDetails.contentRating.catvRating	string Hệ thống phân loại của Canada TV – Hệ thống phân loại truyền hình của Canada là mức phân loại video của Ủy ban Truyền thông và Truyền thông Canada (CRTC) của Canada về các chương trình phát sóng bằng tiếng Anh ở Canada. Để biết thêm thông tin, hãy xem trang web của Hội đồng tiêu chuẩn phát thanh Canada. Các giá trị hợp lệ cho thuộc tính này là: catv14plus – 14 trở lên catv18plus – 18 tuổi trở lên catvC – C catvC8 – C8 catvG – G catvPg – PG catvUnrated
contentDetails.contentRating.catvfrRating	string Điểm đánh giá video của Ủy ban Vô tuyến 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 thanh Canada. Các giá trị hợp lệ cho thuộc tính này là: catvfr13plus – 13 trở lên catvfr16plus – 16 tuổi trở lên catvfr18plus – 18 tuổi trở lên catvfr8plus – 8 trở lên catvfrG – G catvfrUnrated
contentDetails.contentRating.cbfcRating	string Điểm xếp hạng của Chứng nhận Uỷ ban Điện ảnh Trung ương (CBFC – Ấn Độ) của video. Giá trị hợp lệ của cơ sở lưu trú này là: cbfcA – A cbfcS – S cbfcU – U cbfcUnrated cbfcUA – U/A cbfcUA7plus – U/A cbfcUA13plus – U/A cbfcUA16plus – U/A
contentDetails.contentRating.cccRating	string Điểm xếp hạng Consejo de Calificación Cinematográfica (Chile) của video. Giá trị hợp lệ của cơ sở lưu trú này là: ccc14 – 14 trở lên ccc18 – 18 tuổi trở lên ccc18s – 18+ – nội dung khiêu dâm khiêu dâm ccc18v – 18+ – contenido excesivamente forceo ccc6 – 6+ – Inoreniente para menores de 7 años cccTe – Khách hàng tiềm năng cccUnrated
contentDetails.contentRating.cceRating	string Điểm xếp hạng của video từ Co đăngão de Classificação de Espect `culos của Bồ Đào Nha. Các giá trị hợp lệ cho tài sản này là: cceM12 đến 12 cceM14 đến 14 cceM16 đến 16 cceM18 – 18 cceM4 – 4 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ệ cho tài sản này là: chfilm0 – 0 chfilm12 đến 12 chfilm16 đến 16 chfilm18 – 18 chfilm6 – 6 chfilmUnrated
contentDetails.contentRating.chvrsRating	string Điểm xếp hạng của Hệ thống xếp hạng video tại nhà ở Canada (CHVRS) của video. Giá trị hợp lệ cho cơ sở lưu trú này là: chvrs14a – 14A chvrs18a – 18A chvrsE – E chvrsG – G chvrsPg – PG chvrsR – R chvrsUnrated
contentDetails.contentRating.cicfRating	string Điểm đánh giá của video từ Ủy ban Conttrole des Films (Bỉ). Giá trị hợp lệ cho tài sản này là: cicfE – E cicfKntEna – KNT/ENA cicfKtEa – KT/EA cicfUnrated
contentDetails.contentRating.cnaRating	string Điểm đánh giá của video từ CONSILUL NATIONAL AL AUDIOVIZUALULUI (CNA) của Romania. Các giá trị hợp lệ cho tài sản này là: cna12 đến 12 cna15 đến 15 cna18 – 18 cna18plus – 18 tuổi trở lên cnaAp – AP cnaUnrated
contentDetails.contentRating.cncRating	string Hệ thống phân loại ở Pháp – Rạp chiếu phim phân loại phí hoa hồng Các giá trị hợp lệ cho tài sản này là: cnc10 đến 10 cnc12 đến 12 cnc16 đến 16 cnc18 – 18 cncE – E cncT đến T cncUnrated
contentDetails.contentRating.csaRating	string Điểm xếp hạng của video từ Conseil supérieur de l?audiovisuel của Pháp đánh giá nội dung phát sóng. Các giá trị hợp lệ của tài sản này là: csa10 đến 10 csa12 đến 12 csa16 đến 16 csa18 – 18 csaInterdiction – Sắc lệnh csaT đến T csaUnrated
contentDetails.contentRating.cscfRating	string Điểm đánh giá của video từ Uỷ ban giám sát của Luxembourg về việc phân loại phim (CSCF). Giá trị hợp lệ của tài sản này là: cscf12 đến 12 cscf16 đến 16 cscf18 – 18 cscf6 – 6 cscf9 đến 9 người cscfA – A cscfAl – AL cscfUnrated
contentDetails.contentRating.czfilmRating	string Điểm xếp hạng của video ở Cộng hòa Séc. Các giá trị hợp lệ cho tài sản này là: czfilm12 đến 12 czfilm14 đến 14 czfilm18 – 18 czfilmU – U czfilmUnrated
contentDetails.contentRating.djctqRating	string Điểm đánh giá của Exitamento de Justiça, Classificação, Qualificação e Títulos (DJCQT – Brazil) của video này. Giá trị hợp lệ của tài sản này là: djctq10 đến 10 djctq12 đến 12 djctq14 đến 14 djctq16 đến 16 djctq18 – 18 djctqL – Trái djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list Lý do khiến video đó nhận được điểm xếp hạng DJCQT (Brazil).
contentDetails.contentRating.ecbmctRating	string Hệ thống phân loại tại Thổ Nhĩ Kỳ – Hội đồng đánh giá và phân loại của Bộ Văn hóa và Du lịch Các giá trị hợp lệ cho cơ sở lưu trú này là: ecbmct13a – 13A ecbmct13plus – 13 trở lên ecbmct15a – 15A ecbmct15plus – 15 trở lên ecbmct18plus – 18 tuổi trở lên ecbmct7a – 7A ecbmct7plus – Trên 7 ecbmctG – G ecbmctUnrated ecbmct6a – 6A ecbmct6plus – 6 trở lên ecbmct10a – 10A ecbmct10plus – 10 trở lên ecbmct16plus – 16 tuổi trở lên
contentDetails.contentRating.eefilmRating	string Điểm xếp hạng của video ở Estonia. Các giá trị hợp lệ cho tài sản này là: eefilmK12 – K-12 eefilmK14 – K-14 eefilmK16 – K-16 eefilmK6 – K-6 eefilmL – Trái 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ệ cho tài sản này là: egfilm18 – 18 egfilmBn – BN egfilmGn – GN egfilmUnrated
contentDetails.contentRating.eirinRating	string Điểm xếp hạng Eirin (映倫) của video. Eirin là hệ thống xếp hạng của Nhật Bản. Giá trị hợp lệ cho thuộc tính này là: eirinG – G eirinPg12 – PG-12 eirinR15plus đến R15 trở lên eirinR18plus – R18 trở lên eirinUnrated
contentDetails.contentRating.fcbmRating	string Điểm xếp hạng của video trong Hội đồng kiểm duyệt phim của Malaysia. Giá trị hợp lệ của cơ sở lưu trú này là: fcbm18 – 18 fcbm18pa – 18PA fcbm18pl – 18 PL fcbm18sg – 18 SG fcbm18sx – 18 giây fcbmP13 – P13 fcbmPg13 đến PG13 fcbmU – U fcbmUnrated
contentDetails.contentRating.fcoRating	string Điểm đánh giá video của Văn phòng Điện ảnh, Báo chí và Bài viết ở Hong Kong. Giá trị hợp lệ của tài sản này là: fcoI – I fcoIi – II fcoIia – IIA fcoIib – IIB fcoIii – III fcoUnrated
contentDetails.contentRating.fmocRating	string Tính năng này đã ngừng hoạt động kể từ ngày 2 tháng 11 năm 2015. Thay vào đó, hãy dùng tài sản contentDetails.contentRating.cncRating. Điểm xếp hạng trong video của Trung tâm quốc gia về cinéma et de l'image animé (Bộ Văn hóa Pháp) . Các giá trị hợp lệ cho tài sản này là: fmoc10 đến 10 fmoc12 đến 12 fmoc16 đến 16 fmoc18 – 18 fmocE – E fmocU – U fmocUnrated
contentDetails.contentRating.fpbRating	string Điểm xếp hạng của video trong Ban phim và xuất bản của Nam Phi. Giá trị hợp lệ của tài sản này là: fpb10 đến 10 fpb1012Pg – 10 – 12PG fpb13 đến 13 fpb16 đến 16 fpb18 – 18 fpb79Pg – 7 – 9PG fpbA – A fpbPg – PG fpbUnrated fpbX18 – X18 fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[]	list Lý do khiến video đó được xếp hạng FPB (Nam Phi).
contentDetails.contentRating.fskRating	string Điểm xếp hạng của video FreiWillige Selbstkontrolle der Filmwirtschaft (FSK – Đức) của video. Giá trị hợp lệ cho tài sản này là: fsk0 – FSK 0 fsk12 – FSK 12 fsk16 – FSK 16 fsk18 – FSK 18 fsk6 – FSK 6 fskUnrated
contentDetails.contentRating.grfilmRating	string Điểm xếp hạng của video ở Hy Lạp. Các giá trị hợp lệ cho tài sản này là: grfilmE – E grfilmK đến 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) của video này. Giá trị hợp lệ cho tài sản này là: icaa12 đến 12 icaa13 đến 13 icaa16 đến 16 icaa18 – 18 icaa7 – 7 icaaApta – APTA icaaUnrated icaaX đến 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ệ cho tài sản này là: ifco12 đến 12 ifco12a – 12A ifco15 đến 15 ifco15a – 15A ifco16 đến 16 ifco18 – 18 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ệ cho tài sản này là: ilfilm12 đến 12 ilfilm16 đến 16 ilfilm18 – 18 ilfilmAa – AA ilfilmUnrated
contentDetails.contentRating.incaaRating	string Mức phân loại video của INCAA (Instituto Nacional de Cine y Artes Audiovisuales – Argentina) . Giá trị hợp lệ của tài sản 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 Điểm xếp hạng của video do Ban phân loại phim Kenya thực hiện. Giá trị hợp lệ của tài sản này là: kfcb16plus đến 16 kfcbG – GE kfcbPg – PG kfcbR – 18 kfcbUnrated
contentDetails.contentRating.kijkwijzerRating	string voor de Classificatie van Audiovisuele Media (Hà Lan). Các giá trị hợp lệ cho tài sản này là: kijkwijzer12 đến 12 kijkwijzer16 đến 16 kijkwijzer18 – 18 kijkwijzer6 – 6 kijkwijzer9 đến 9 người kijkwijzerAl – AL kijkwijzerUnrated
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 (조조물조급터เCAMPAIGN). KMRB đánh giá video ở Hàn Quốc. Giá trị hợp lệ của cơ sở lưu trú này là: kmrb12plus – 12세 MATCHع 관람カ kmrb15plus – 15세 BOLD리 관람カ kmrbAll – Được체관람カ kmrbR – 청소년 관람불カ kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string Điểm xếp hạng của video từ Phim cảm biến Lembaga của Indonesia. Giá trị hợp lệ của cơ sở lưu trú này là: lsf13 đến 13 lsf17 – 17 lsf21 – 21 lsfA – A lsfBo – BO lsfD – D lsfR – R lsfSu – Thuỵ Sĩ lsfUnrated
contentDetails.contentRating.mccaaRating	string Điểm xếp hạng của video từ Ban phân loại độ tuổi phim của Malta. Giá trị hợp lệ cho tài sản này là: mccaa12 đến 12 mccaa12a – 12A mccaa14 – 14 – mức phân loại này đã bị xoá khỏi cấu trúc phân loại mới ra mắt vào năm 2013. mccaa15 đến 15 mccaa16 – 16 – mức phân loại này đã bị xoá khỏi cấu trúc phân loại mới ra mắt vào năm 2013. mccaa18 – 18 mccaaPg – PG mccaaU – U mccaaUnrated
contentDetails.contentRating.mccypRating	string Điểm xếp hạng của video từ Hội đồng truyền thông dành cho trẻ em và giới trẻ của Viện phim Đan Mạch (Det Danske Filminstitut) .Các giá trị hợp lệ cho tài sản này là: mccyp11 đến 11 mccyp15 đến 15 mccyp7 – 7 mccypA – A mccypUnrated
contentDetails.contentRating.mcstRating	string Hệ thống xếp hạng 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
contentDetails.contentRating.mdaRating	string Điểm đánh giá video của Cơ quan phát triển truyền thông Singapore (MDA) và cụ thể là Hội đồng kiểm duyệt phim (BFC). Giá trị hợp lệ cho tài sản này là: mdaG – G mdaM18 – M18 mdaNc16 – NC16 mdaPg – PG mdaPg13 đến PG13 mdaR21 đến R21 mdaUnrated
contentDetails.contentRating.medietilsynetRating	string Điểm xếp hạng video từ Medietilsynet, Cơ quan truyền thông Na Uy. Giá trị hợp lệ của tài sản này là: medietilsynet11 đến 11 medietilsynet12 đến 12 medietilsynet15 đến 15 medietilsynet18 – 18 medietilsynet6 – 6 medietilsynet7 – 7 medietilsynet9 đến 9 người medietilsynetA – A medietilsynetUnrated
contentDetails.contentRating.mekuRating	string Điểm xếp hạng của video từ Kansallinen Audiovisuaalinen Instituutti (Viện nghe nhìn quốc gia) của Phần Lan. Giá trị hợp lệ cho tài sản này là: meku12 đến 12 meku16 đến 16 meku18 – 18 meku7 – 7 mekuS – S mekuUnrated
contentDetails.contentRating.mibacRating	string Điểm xếp hạng của video trên kênh Ministero dei Beni e delle Attività Culturei e del Turismo (Ý). 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 Ministerio de Cultura (Colombia) của video. Giá trị hợp lệ của cơ sở lưu trú này là: moc12 đến 12 moc15 đến 15 moc18 – 18 moc7 – 7 mocBanned – Bị cấm mocE – E mocT đến T mocUnrated mocX đến X
contentDetails.contentRating.moctwRating	string Điểm đánh giá video của Bộ Văn hóa Đài Loan (文化部). Giá trị hợp lệ của cơ sở lưu trú này là: moctwG – G moctwP – P moctwPg – PG moctwR – R moctwR12 – R-12 moctwR15 – R-15 moctwUnrated
contentDetails.contentRating.mpaaRating	string Điểm xếp hạng của Hiệp hội điện ảnh Hoa Kỳ (MPAA). Các giá trị hợp lệ cho tài sản này là: mpaaG – G mpaaNc17 – NC-17 mpaaPg – PG mpaaPg13 – PG-13 mpaaR – R mpaaUnrated
contentDetails.contentRating.mpaatRating	string Điểm xếp hạng của Hiệp hội điện ảnh Hoa Kỳ về đoạn giới thiệu phim và bản xem trước. Giá trị hợp lệ cho cơ sở lưu trú này là: mpaatGb – GB (Băng tần xanh lục – Đã phê duyệt cho tất cả đối tượng) mpaatRb – RB (Băng tần đỏ – Đề xuất cho 17 tuổi trở lên)
contentDetails.contentRating.mtrcbRating	string Điểm xếp hạng của video trong Hội đồng đánh giá và phân loại phim và truyền hình (Philippines). 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 đến X
contentDetails.contentRating.nbcRating	string Điểm đánh giá của video từ Cục phân loại quốc gia Maldives. Giá trị hợp lệ của tài sản này là: nbc12plus – 12 trở lên nbc15plus – 15 trở lên nbc18plus – 18 tuổi trở lên nbc18plusr – 18+R nbcG – G nbcPg – PG nbcPu – PU nbcUnrated
contentDetails.contentRating.nfrcRating	string Điểm xếp hạng của video trong Trung tâm phim quốc gia Bulgaria. Giá trị hợp lệ của cơ sở lưu trú này là: nfrcA – A nfrcB – B nfrcC – C nfrcD – D nfrcUnrated nfrcX đến X
contentDetails.contentRating.nfvcbRating	string Điểm xếp hạng của video trong Hội đồng điều tra dân số và video quốc gia của Nigeria. Giá trị hợp lệ của tài sản này là: nfvcb12 đến 12 nfvcb12a – 12A nfvcb15 đến 15 nfvcb18 – 18 nfvcbG – G nfvcbPg – PG nfvcbRe – RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string Điểm đánh giá của video từ Nacionãlais Kino centrs (Trung tâm phim quốc gia Latvia). Các giá trị hợp lệ cho tài sản này là: nkclv12plus – 12 trở lên nkclv18plus – 18 tuổi trở lên nkclv7plus – Trên 7 nkclvU – U nkclvUnrated
contentDetails.contentRating.oflcRating	string Mức phân loại của Văn phòng Điện ảnh và Phân loại văn bản (OFLC – New Zealand) của video. Các giá trị hợp lệ của tài sản này là: oflcG – G oflcM – M oflcPg – PG oflcR13 đến R13 oflcR15 đến R15 oflcR16 đến R16 oflcR18 đến R18 oflcRp13 – 13 RP oflcRp16 – 16 RP oflcUnrated
contentDetails.contentRating.pefilmRating	string Điểm xếp hạng của video ở Peru. Các giá trị hợp lệ cho tài sản này là: pefilm14 đến 14 pefilm18 – 18 pefilmPg – PG pefilmPt – Giờ Thái Bình Dương pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating	string Điểm xếp hạng của video ở Venezuela. Giá trị hợp lệ của cơ sở lưu trú này là: resorteviolenciaA – A resorteviolenciaB – B resorteviolenciaC – C resorteviolenciaD – D resorteviolenciaE – E resorteviolenciaUnrated
contentDetails.contentRating.rtcRating	string Tổng giám đốc của Bộ Phát thanh, Truyền hình và Điện ảnh (Mexico) của video. Các giá trị hợp lệ cho tài sản này là: rtcA – A rtcAa – AA rtcB – B rtcB15 – B15 rtcC – C rtcD – D rtcUnrated
contentDetails.contentRating.rteRating	string Điểm xếp hạng của video từ Raidió Teilifís Éireann của Ireland. Giá trị hợp lệ của cơ sở lưu trú này là: rteCh – Thụy Sĩ rteGa – Google Analytics rteMa – MA rtePs – Lưu ý rteUnrated
contentDetails.contentRating.russiaRating	string Điểm xếp hạng của Cơ quan đăng ký phim quốc gia của Liên bang Nga (MKRF – Nga). Giá trị hợp lệ của tài sản này là: russia0 – 0 trở lên russia12 – 12 trở lên russia16 – 16 tuổi trở lên russia18 – 18 tuổi trở lên russia6 – 6 trở lên russiaUnrated
contentDetails.contentRating.skfilmRating	string Điểm xếp hạng của video ở Slovakia. 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 ở Iceland. Các giá trị hợp lệ cho tài sản này là: smais12 đến 12 smais14 đến 14 smais16 đến 16 smais18 – 18 smais7 – 7 smaisL – Trái smaisUnrated
contentDetails.contentRating.smsaRating	string Điểm đánh giá của video từ Statens medieråd (Hội đồng Truyền thông Quốc gia Thuỵ Điển). Giá trị hợp lệ của tài sản này là: smsa11 đến 11 smsa15 đến 15 smsa7 – 7 smsaA – Tất cả độ tuổi smsaUnrated
contentDetails.contentRating.tvpgRating	string Điểm xếp hạng nguyên tắc về cha mẹ trên truyền hình (TVPG) của video. Giá trị hợp lệ cho 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 sử dụng để xác định nội dung bị giới hạn độ tuổi. Giá trị hợp lệ cho tài sản này là: ytAgeRestricted
contentDetails.projection	string Chỉ định định dạng chiếu của video. Giá trị hợp lệ cho thuộc tính này là: 360 rectangular
contentDetails.hasCustomThumbnail	boolean Cho biết người tải video lên có cung cấp hình thu nhỏ tuỳ chỉnh cho video hay không. Chỉ người tải video lên mới thấy 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à bảo mậ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 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 video không tải lên được. Thuộc tính này chỉ xuất hiện nếu thuộc tính uploadStatus cho biết không thể tải lên. Các giá trị hợp lệ cho thuộc tính 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. 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. Giá trị hợp lệ cho thuộc tính 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ệ cho tài sản này là: private public unlisted
status.publishAt	datetime Ngày và giờ xuất bản video. Bạn chỉ có thể thiết lập trạng thái quyền riêng tư của video là riêng tư. Giá trị này được chỉ định ở định dạng ISO 8601. Vui lòng lưu ý hai điểm bổ sung sau đây liên quan đến hành vi của tài sản này: Nếu đặt giá trị của thuộc tính này khi gọi phương thức videos.update, thì 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 một video vào một thời điểm trong quá khứ, thì video đó sẽ được xuất bản ngay lập tức. Do đó, tác động của việc đặt thuộc tính status.publishAt thành ngày và giờ trước đây giống như việc thay đổi privacyStatus của video từ private thành public.
status.license	string Giấy phép sử dụng video. Giá trị hợp lệ cho thuộc tính này là: creativeCommon youtube
status.embeddable	boolean Giá trị này cho biết liệu video có thể được nhúng vào 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ê về video mở rộng 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à số liệu thống kê như số lượt xem và điểm xếp hạng của một video vẫn sẽ xuất hiện công khai ngay cả khi bạn đặt giá trị của tài sản này là 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 và có chứa trạng thái hiện tại là "dành cho trẻ em" hay không. 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. Xem Trung tâm trợ giúp YouTube để biết thêm thông tin về cách đặt đối tượng người xem cho kênh, video hoặc nội dung phát sóng của bạn.
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à 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 cho 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ượ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. Tức là tài sản này chỉ có trong một phản hồi API nếu yêu cầu API đã được chủ sở hữu video xác thực. Vui lòng xem lịch sử 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 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ố lượt bình luận của video.
player	object Đối tượng player chứa thông tin mà bạn sẽ 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. 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, trình phát được nhúng sẽ mặc định là định dạng 4:3.
player.embedHeight	long Chiều cao của trình phát được nhúng đã trả về trong thuộc tính player.embedHtml. Thuộc tính này chỉ được trả về nếu yêu cầu đã chỉ định một giá trị cho tham số maxHeight và/hoặc maxWidth và tỷ lệ khung hình của video đã biết.
player.embedWidth	long Chiều rộng của trình phát được nhúng trả về trong thuộc tính player.embedHtml. Thuộc tính này chỉ được trả về nếu yêu cầu đã chỉ định một giá trị cho tham số maxHeight và/hoặc maxWidth và tỷ lệ khung hình của video đã biết.
topicDetails	object Đối tượng topicDetails đóng gói thông tin về các chủ đề liên quan đến video. Quan trọng: Xem định nghĩa của thuộc tính topicDetails.relevantTopicIds[] và topicDetails.topicIds[] cũng như lịch sử 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 Quan trọng: Tài sản này không còn được dùng nữa kể từ ngày 10 tháng 11 năm 2016. API không còn trả về giá trị cho thuộc tính này nữa và mọi chủ đề liên kết với video hiện đều được trả về bằng giá trị thuộc tính topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[]	list Danh sách mã chủ đề liên quan đến video. Tính năng này không còn được dùng nữa kể từ ngày 10 tháng 11 năm 2016. API này sẽ được hỗ trợ cho đến hết ngày 10 tháng 11 năm 2017. Quan trọng: Do SDK cơ sở và Freefree API ngừng hoạt động nên mã chủ đề bắt đầu hoạt động 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. Xem 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ủ đề chính) /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 Nhạc độc lập /m/03_d0 Nhạc Jazz /m/028sqc 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à Blues /m/06by7 Nhạc rock /m/0gywn Nhạc Soul Chủ đề trò chơi /m/0bzvm2 Trò chơi (chủ đề gốc) /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ử ca 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ủ đề gốc) /m/0jm_ Bóng bầu dục Mỹ /m/018jz Bóng chày /m/018w8 Bóng rổ /m/01cgz Đấm bốc /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ủ đề chính) /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 Phong cách sống (chủ đề gốc) /m/032tl Thời trang /m/027x7n Thể dục /m/02wbm Đồ ăn /m/03glg Sở thích /m/068hy Thú cưng /m/041xxh Sự hấp dẫn về thể chất [Sản phẩm làm đẹp] /m/07c1v Công nghệ /m/07bxq Du lịch /m/07yv9 Phương tiện vận chuyển Chủ đề xã hội /m/098wr Xã hội (chủ đề gốc) /m/09s1f Kinh doanh /m/0kt51 Sức khoẻ /m/01h6rj Quân đội /m/05qt0 Chính trị /m/06bvp Tôn giáo Các chủ đề khác /m/01k8wb Tri thức
topicDetails.topicCategories[]	list Danh sách các URL trên Wikipedia cung cấp nội dung mô tả tổng thể về nội dung của video.
recordingDetails	object Đối tượng recordingDetails gồm thông tin về vị trí, ngày và địa chỉ quay video.
recordingDetails.locationDescription	string Tính năng 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ả về vị trí quay video.
recordingDetails.location	object Thông tin vị trí địa lý liên kết với video. Xin lưu ý rằng các 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. Người dùng có thể chỉnh sửa, tìm kiếm được video này trên các video công khai và có thể hiển thị cho người dùng trong các video công khai.
recordingDetails.location.latitude	double Tính năng 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. Vĩ độ theo độ.
recordingDetails.location.longitude	double Tính năng 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. Kinh độ theo độ.
recordingDetails.location.altitude	double Tính năng này đã ngừng hoạt động 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 trên elip tham chiếu, tính bằng mét.
recordingDetails.recordingDate	datetime Ngày và giờ quay video. Giá trị này được chỉ định ở định dạng ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails	object Đối tượng fileDetails đóng gói thông tin về tệp video đã tải lên YouTube, bao gồm độ phân giải, thời lượng, codec â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ị available.
fileDetails.fileName	string Tên của tệp đã tải lên. Trường này cho biết tệp video hoặc loại tệp khác đã được tải lên hay chưa.
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 cho biết tệp video hoặc loại tệp khác đã được tải lên hay chưa.
fileDetails.fileType	string Loại tệp tải lên mà công cụ xử lý video của YouTube phát hiện được. Hiện tại, YouTube chỉ xử lý các tệp video, nhưng trường này hiện chứa tệp video hoặc 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à tệp lưu trữ, chẳng hạn như tệp lưu trữ .zip. audio – Tệp là loại tệp âm thanh đã biết, chẳng hạn như tệp .mp3. document – Tệp này là 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 này là 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 này 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 tế. video – Tệp này là 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 được mã hóa tính bằng pixel. Bạn có thể tính tỷ lệ khung hình mã hoá của video là width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels	unsigned integer Chiều cao của nội dung video được mã hóa tính bằng pixel.
fileDetails.videoStreams[].frameRateFps	double Tốc độ khung hình của luồng video, tính bằng số khung hình/giây.
fileDetails.videoStreams[].aspectRatio	double Tỷ lệ khung hình của nội dung video, giúp 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 phát 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 Lượng nội dung mà YouTube cần để xoay vòng nội dung nguồn ban đầu để hiển thị video đúng cách. Giá trị hợp lệ cho thuộc tính này là: clockwise – Bạn phải xoay video 90 độ theo chiều kim đồng hồ. counterClockwise – Video cần phải xoay 90 độ ngược chiều kim đồng hồ. none – Không cần xoay video. other – Bạn cần xoay video theo cách khác và không quan trọng. upsideDown – Video phải được xoay ngược.
fileDetails.videoStreams[].vendor	string Giá trị nhận dạng duy nhất nhà cung cấp video. Thông thường, giá trị 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 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 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ị nhận dạng duy nhất nhà cung cấp video. Thông thường, giá trị là mã nhà cung cấp gồm bốn chữ cái.
fileDetails.durationMs	unsigned long Thời lượng video đã tải lên tính bằng mili giây.
fileDetails.bitrateBps	unsigned long Tốc độ bit kết hợp (của 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 tải lên. Giá trị này được chỉ định ở định dạng ISO 8601. Hiện tại, các định dạng ISO 8601 sau đây được hỗ trợ: Chỉ có ngày: YYYY-MM-DD Thời gian ngủ: YYYY-MM-DDTHH:MM:SS Thời gian theo 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 xử lý tệp video đã tải lên của YouTube. Các thuộc tính trong đối tượng xác định trạng thái xử lý hiện tại và thời gian còn lại ước tính cho đến khi YouTube xử lý xong video. Phần này cũng cho biết video có các loại dữ liệu hoặc nội dung khác nhau hay không, chẳng hạn như thông tin chi tiết về tệp hoặc hình thu nhỏ. Đối tượng processingProgress được thiết kế để thăm dò ý kiến để video đã tải lên có thể theo dõi tiến trình YouTube 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 YouTube có thể xử lý video hay không, hoặc liệu video có đang được xử lý hay không. Giá trị hợp lệ của tài sản này là: failed – Không xử lý được video. Xem ProcessFailureReason. processing – Video đang được xử lý. Xem ProcessProgress. succeeded – Video đã được xử lý thành công. terminated – Thông tin xử lý không còn tồn tại.
processingDetails.processingProgress	object Đối tượng processingProgress chứa thông tin về tiến độ YouTube đã thực hiện trong quá trình xử lý video. Các giá trị này thực sự chỉ phù hợp nếu trạng thái xử lý của video là processing.
processingDetails.processingProgress.partsTotal	unsigned long Số liệu ước tính về tổng số phần cần xử lý 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ố lượng phần được ước tính có thể tăng mà số lượng phần đã được xử lý lại không tăng tương ứng, nên tiến trình tính toán có thể giảm định kỳ trong khi YouTube xử lý video.
processingDetails.processingProgress.timeLeftMs	unsigned long Ước tính khoảng thời gian (tính bằng giây) mà YouTube cần để hoàn tất việc xử lý video.
processingDetails.processingFailureReason	string Lý do YouTube không xử lý được video. Tài sản này sẽ chỉ có giá trị nếu giá trị của tài sản processingStatus là failed. Các giá trị hợp lệ cho tài sản này là: other – Không xử lý được một số thành phần xử lý khác. streamingFailed – Không thể gửi video cho 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 thông tin chi tiết về tệp có cho video mà bạn tải lên hay không. Bạn có thể truy xuất thông tin chi tiết về tệp của video bằng cách yêu cầu phần fileDetails trong yêu cầu videos.list().
processingDetails.processingIssuesAvailability	string Giá trị này cho biết công cụ xử lý video đã tạo ra các đề xuất có thể giúp YouTube cải thiện khả năng xử lý video, cảnh báo giải thích các sự cố xử lý video hoặc lỗi gây ra sự 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 video có các đề xuất từ khoá (thẻ) hay không. Bạn có thể thêm thẻ vào siêu dữ liệu của một video để giúp người dùng khác dễ dàng tìm thấy video đó. Bạn có thể truy xuất các đề xuất này bằng cách yêu cầu phần suggestions trong yêu cầu videos.list().
processingDetails.editorSuggestionsAvailability	string Giá trị này cho biết liệu 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().
processingDetails.thumbnailsAvailability	string Giá trị này cho biết liệu hình thu nhỏ có được tạo cho video hay không.
suggestions	object Đối tượng suggestions đóng gói các đề xuất xác định cơ hội cải thiện chất lượng video hoặc siêu dữ liệu cho video đã tải lên. Chỉ chủ sở hữu video mới có thể truy xuất dữ liệu này. Đối tượng suggestions sẽ chỉ được trả về nếu thuộc tính processingDetails.tagSuggestionsAvailability hoặc thuộc tính processingDetails.editorSuggestionsAvailability có giá trị là available.
suggestions.processingErrors[]	list Danh sách các lỗi sẽ khiến YouTube không xử lý được 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, cuối cùng thì trạng thái đó gần như chắc chắn là failed. Các giá trị hợp lệ cho thuộc tính 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ụ: 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 tải lên hoặc việc này 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 xử lý tệp video đã tải lên. Ngoài ra, các phương diện này xác định sự cố 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 sự cố như sự cố đồng bộ hóa, 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 – Danh sách chỉnh sửa hiện không được hỗ trợ. inconsistentResolution – Độ phân giải vùng chứa và luồng xung đột với nhau. 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ã hóa và giải mã âm thanh không được công nhận, có khả năng không chuyển mã được. unknownContainer – Định dạng tệp không thể nhận dạng, việc chuyển mã có thể không thành công. unknownVideoCodec – Codec video không nhận dạng được, có khả năng không chuyển mã được.
suggestions.processingHints[]	list Danh sách các đề xuất có thể giúp YouTube cải thiện khả năng xử lý video. Các giá trị hợp lệ cho tài sản này là: nonStreamableMov – Tệp MP4 không thể phát trực tuyến được, việc này sẽ làm chậm quá trình xử lý. sendBestQualityVideo – Có thể phiên bản video này đạt chất lượng cao hơn.
suggestions.tagSuggestions[]	list Danh sách các thẻ từ khoá có thể được thêm vào siêu dữ liệu của video để tăng khả năng người dùng tìm thấy video của bạn khi tìm kiếm hoặc duyệt xem trên YouTube.
suggestions.tagSuggestions[].tag	string Thẻ từ khoá được đề xuất cho video.
suggestions.tagSuggestions[].categoryRestricts[]	list Một bộ danh mục video mà thẻ có liên quan. Bạn có thể sử dụng thông tin này để đưa ra 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, đề 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 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ệ cho thuộc tính này là: audioQuietAudioSwap – Bản âm thanh có vẻ im lặng và có thể bị hoán đổi với bản âm thanh có chất lượng tốt hơn. videoAutoLevels – Độ sáng của hình ảnh có vẻ như đang tắt và có thể điều chỉnh được. videoCrop – Lề (sáng) được phát hiện xung quanh ảnh có thể bị cắt. videoStabilize – Video có vẻ rung và có thể ổn định.
liveStreamingDetails	object Đối tượng liveStreamingDetails chứa siêu dữ liệu về chương trình phát video trực tiếp. Đối tượng này sẽ chỉ xuất hiện trong một tài nguyên video nếu video đó là một chương trình phát trực tiếp sắp diễn ra, trực tiếp hoặc đã kết thúc.
liveStreamingDetails.actualStartTime	datetime Thời gian thực sự phát sóng. Giá trị này được chỉ định ở định dạng ISO 8601. Giá trị này sẽ không xuất hiện cho đến khi chương trình phát sóng bắt đầu.
liveStreamingDetails.actualEndTime	datetime Thời gian thực sự phát sóng. Giá trị này được chỉ định ở định dạng ISO 8601. Giá trị này sẽ không xuất hiệ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 phát sóng theo lịch. Giá trị này được chỉ định ở định dạng ISO 8601.
liveStreamingDetails.scheduledEndTime	datetime Thời gian phát sóng dự kiến kết thúc. Giá trị này được chỉ định ở định dạng ISO 8601. Nếu giá trị trống hoặc không có thuộc tính, thì thông báo sẽ được lên lịch để tiếp tục vô thời hạn.
liveStreamingDetails.concurrentViewers	unsigned long Số lượng ngườ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ẽ hiện diệ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 đó. Lưu ý rằng YouTube dừng theo dõi số người xem đồng thời của một chương trình phát sóng khi chương trình phát đó kết thúc. Vì vậy, thuộc tính này sẽ không xác định số lượng người xem video lưu trữ của một chương trình phát sóng trực tiếp đã kết thúc.
liveStreamingDetails.activeLiveChatId	string Mã của cuộc trò chuyện trực tiếp hiện đang hoạt động đí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 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 chương trình phát sóng liên tục, mã trò chuyện trực tiếp sẽ không còn liên kết với video này mà được liên kết với video mới đang xuất hiện 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 Thông tin mô tả video đã bản địa hoá.