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ị giới hạn ở chế độ xem riêng tư. Để gỡ bỏ quy định hạn chế này, mỗi dự án API phải trải qua quy trình kiểm tra để xác minh 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 thông tin chi tiết.

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

Phương thức

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

getRating

Truy xuất điểm xếp hạng mà người dùng được uỷ quyền đã đưa ra cho danh sách video được chỉ định. Thử ngay.

list

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

chèn

Tải video lên YouTube và tuỳ ý đặt siêu dữ liệu của video.

update

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

xóa

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

rate

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

reportAbuse

Báo cáo video có chứa nội dung sai trái. Thử ngay.

Biểu thị tài nguyên

Cấu trúc JSON sau đây cho thấy định dạng của tài nguyên videos:

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Thuộc tính

Bảng sau đây xác định các thuộc tính xuất hiện trong tài nguyên này:

Thuộc tính
kind	string Xác định loại tài nguyên API. Giá trị sẽ là youtube#video.
etag	etag Etag của tài nguyên này.
id	string Mã mà YouTube sử dụng để xác định riêng biệt video.
snippet	object Đối tượng snippet chứa các thông tin cơ bản về video, chẳng hạn như tiêu đề, nội dung mô tả và danh mục.
snippet.publishedAt	datetime Ngày và giờ xuất bản video. Xin lưu ý rằng thời gian này có thể khác với thời gian tải video lên. Ví dụ: nếu một video được tải lên ở chế độ riêng tư rồi chuyển sang chế độ công khai sau đó, thì thuộc tính này sẽ chỉ định thời điểm video được chuyển sang chế độ công khai. Có một số trường hợp đặc biệt: Nếu một video được tải lên ở chế độ riêng tư và chủ sở hữu kênh truy xuất siêu dữ liệu của video đó, thì giá trị thuộc tính này sẽ chỉ định ngày và giờ tải video lên. Nếu một video được tải lên ở chế độ không công khai, thì giá trị thuộc tính này 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 của video. Giá trị đượ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 duy nhất kênh mà video được tải lên.
snippet.title	string Tiêu đề của video. Giá trị thuộc tính có độ dài tối đa là 100 ký tự và có thể chứa tất cả ký tự UTF-8 hợp lệ ngoại trừ < và >. Bạn phải đặt giá trị cho thuộc tính này nếu gọi phương thức videos.update và đang cập nhật phần snippet của tài nguyên video.
snippet.description	string Nội dung mô tả video. Giá trị thuộc tính có độ dài tối đa là 5000 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à 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 một video (hoặc tài nguyên tham chiếu đến một 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 120 pixel và chiều cao 90 pixel. Hình thu nhỏ mặc định của kênh có chiều rộng 88 pixel và chiều cao 88 pixel. 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 tham chiếu đến video), hình ảnh này có chiều rộng 320 px và chiều cao 180 px. Đối với kênh, hình ảnh này có chiều rộng 240 pixel và chiều cao 240 pixel. 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 tham chiếu đến video), hình ảnh này có chiều rộng 480 pixel và chiều cao 360 pixel. Đối với kênh, hình ảnh này có chiều rộng 800 pixel và chiều cao 800 pixel. standard – Phiên bản hình thu nhỏ có độ phân giải cao hơn cả hình ảnh có độ phân giải high. Hình ảnh này xuất hiện trên một số video và các tài nguyên khác liên quan đến video, chẳng hạn như 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 640 px và chiều 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 áp dụng cho một số video và các tài nguyên khác liên quan đến video, chẳng hạn như 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 1280 pixel và chiều cao 720 pixel.
snippet.thumbnails.(key).url	string URL của hình ảnh.
snippet.thumbnails.(key).width	unsigned integer Chiều rộng của hình ảnh.
snippet.thumbnails.(key).height	unsigned integer Chiều cao của hình ảnh.
snippet.channelTitle	string Tên kênh của kênh chứa video.
snippet.tags[]	list Danh sách thẻ từ khoá liên kết với video. Thẻ có thể chứa dấu cách. Giá trị thuộc tính có độ dài tối đa là 500 ký tự. Hãy lưu ý các quy tắc sau đây liên quan đến cách tính hạn mức ký tự: 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 sẽ được tính vào giới hạn. Nếu một thẻ chứa dấu cách, thì máy chủ API sẽ xử lý giá trị thẻ như thể giá trị đó được gói trong dấu ngoặc kép và dấu ngoặc kép sẽ tính vào giới hạn ký tự. Vì vậy, đối với 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 liệu video có phải là sự kiện phát trực tiếp sắp diễn ra/đang diễn ra hay không. Hoặc là "none" (không có) nếu video không phải là sự kiện phát trực tiếp sắp diễn ra/đang diễn ra. Các 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 thuộc tính snippet.title và snippet.description của tài nguyên video.
snippet.localized	object Đối tượng snippet.localized chứa tiêu đề và nội dung mô tả đã bản địa hoá cho video hoặc tiêu đề bằng ngôn ngữ mặc định cho siêu dữ liệu của video. 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 thông 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á 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 bạn không chỉ định giá trị tham số hl hoặc bạn chỉ định giá trị nhưng không có siêu dữ liệu được bản địa hoá cho ngôn ngữ được chỉ định. Thuộc tính chứa một 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 đã được bản địa hoá.
snippet.localized.description	string Nội dung mô tả video đã được bản địa hoá.
snippet.defaultAudioLanguage	string Thuộc tính default_audio_language chỉ định ngôn ngữ được nói trong bản âm thanh mặc định của video.
contentDetails	object Đối tượng contentDetails chứa thông tin về nội dung video, bao gồm cả thời lượng video và thông tin cho biết video có phụ đề hay không.
contentDetails.duration	string Thời lượng của video. Giá trị thuộc tính là thời lượng theo chuẩn ISO 8601. Ví dụ: đối với một video có thời lượng ít nhất 1 phút và dưới 1 giờ, thời lượng sẽ có định dạng PT#M#S, trong đó chữ cái PT cho biết giá trị này chỉ định một khoảng thời gian và chữ cái M và S lần lượt đề cập đến thời lượng tính bằng phút và giây. Ký tự # đứng trước chữ cái M và S đều là số nguyên chỉ định số phút (hoặc giây) của video. Ví dụ: giá trị PT15M33S cho biết video có thời lượng 15 phút 33 giây. Nếu video dài ít nhất 1 giờ, thì thời lượng sẽ có định dạng PT#H#M#S, trong đó # đứng trước chữ cái H chỉ định thời lượng video theo giờ và tất cả thông tin chi tiết khác đều giống như mô tả ở trên. Nếu video dài ít nhất một ngày, thì các chữ cái P và T sẽ được phân tách và định dạng của giá trị sẽ là P#DT#H#M#S. Vui lòng tham khảo quy cách ISO 8601 để biết toàn bộ thông tin chi tiết.
contentDetails.dimension	string Cho biết video có ở định dạng 3D hay 2D.
contentDetails.definition	string Cho biết video có ở độ phân giải cao (HD) hay chỉ ở độ phân giải chuẩn. Các giá trị hợp lệ cho thuộc tính này là: hd sd
contentDetails.caption	string Cho biết video có phụ đề hay không. Các giá trị hợp lệ cho thuộc tính này là: false true
contentDetails.licensedContent	boolean Cho biết liệu video có phải là nội dung được cấp phép hay không. Nội dung được cấp phép 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ề những quốc gia mà người dùng có thể (hoặc không thể) xem video. Đối tượng sẽ chứa thuộc tính contentDetails.regionRestriction.allowed hoặc thuộc tính contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[]	list Danh sách mã khu vực xác định các quốc gia có thể xem video. Nếu thuộc tính này có và giá trị của thuộc tính này không liệt kê quốc gia nào, thì video sẽ bị chặn xuất hiện ở quốc gia đó. Nếu thuộc tính này có và chứa danh sách trống, thì video sẽ bị chặn ở tất cả các quốc gia.
contentDetails.regionRestriction.blocked[]	list Danh sách mã khu vực xác định những quốc gia nơi video bị chặn. Nếu thuộc tính này có và không có quốc gia nào được liệt kê trong giá trị của thuộc tính đó, thì người dùng có thể xem video ở quốc gia đó. Nếu thuộc tính này có và chứa danh sách trống, thì video có thể xem được ở mọi quốc gia.
contentDetails.contentRating	object Chỉ định các mức phân loại mà video nhận được theo nhiều hệ thống phân loại.
contentDetails.contentRating.acbRating	string Mức phân loại của video theo Ủy ban phân loại Úc (ACB) hoặc Cơ quan truyền thông và truyền thông Úc (ACMA). Mức phân loại của ACMA được dùng để phân loại chương trình truyền hình dành cho trẻ em. Các giá trị hợp lệ cho thuộc tính này là: acbC – Các chương trình được Cơ quan Thông tin và Truyền thông Úc phân loại là C. Những 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 – M acbMa15plus – MA15+ acbP – Các chương trình được Cơ quan Thông tin và Truyền thông Úc phân loại là P. Các chương trình này dành cho trẻ mẫu giáo. acbPg – PG acbR18plus – R18+ acbUnrated
contentDetails.contentRating.agcomRating	string Mức phân loại của video theo Autorità per le Garanzie nelle Comunicazioni (AGCOM) của Ý. Các giá trị hợp lệ cho thuộc tính này là: agcomT – T agcomUnrated agcomVm14 – VM14 agcomVm18 – VM18
contentDetails.contentRating.anatelRating	string Mức phân loại của Anatel (Asociación Nacional de Televisión) đối với video trên truyền hình Chile. Các giá trị hợp lệ cho thuộc tính 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 Mức phân loại của British Board of Film Classification (BBFC) đối với video. Các giá trị hợp lệ cho thuộc tính này là: bbfc12 – 12 bbfc12a – 12A bbfc15 – 15 bbfc18 – 18 bbfcPg – PG bbfcR18 – R18 bbfcU – U bbfcUnrated
contentDetails.contentRating.bfvcRating	string Mức phân loại của video theo Hội đồng kiểm duyệt phim và video của Thái Lan. Các giá trị hợp lệ cho thuộc tính này là: bfvc13 – 13 bfvc15 – 15 bfvc18 – 18 bfvc20 – 20 bfvcB – B bfvcE – E bfvcG – G bfvcUnrated
contentDetails.contentRating.bmukkRating	string Mức phân loại của video theo Ủy ban phân loại nội dung nghe nhìn của Áo (Bundesministerium für Unterricht, Kunst und Kultur). Các giá trị hợp lệ cho thuộc tính này là: bmukk10 – 10+ bmukk12 – 12+ bmukk14 – Từ 14 tuổi trở lên bmukk16 – Từ 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 dành cho chương trình truyền hình Canada – Canadian TV Classification System (Hệ thống phân loại chương trình truyền hình Canada) Mức phân loại của video do Ủy ban Truyền hình, Đài phát thanh và Viễn thông Canada (CRTC) đưa ra đối với các chương trình truyền hình 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 Truyền hình Canada. Các giá trị hợp lệ cho thuộc tính này là: catv14plus – Từ 14 tuổi trở lên catv18plus – Từ 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 theo Ủy ban Truyền hình, Phát thanh và Viễn thông Canada (CRTC) đối với các chương trình phát sóng bằng tiếng Pháp ở Canada. Để biết thêm thông tin, hãy xem trang web của Canadian Broadcast Standards Council (Hội đồng Tiêu chuẩn Truyền hình Canada). Các giá trị hợp lệ cho thuộc tính này là: catvfr13plus – Từ 13 tuổi trở lên catvfr16plus – Từ 16 tuổi trở lên catvfr18plus – Từ 18 tuổi trở lên catvfr8plus – 8 trở lên catvfrG – G catvfrUnrated
contentDetails.contentRating.cbfcRating	string Mức phân loại của Hội đồng phân loại phim trung ương (CBFC – Ấn Độ) đối với video. Các giá trị hợp lệ cho thuộc tính này là: cbfcA – A cbfcS – S cbfcU – U cbfcUnrated cbfcUA – U/A cbfcUA7plus – U/A cbfcUA13plus – U/A cbfcUA16plus – U/A
contentDetails.contentRating.cccRating	string Mức phân loại của Consejo de Calificación Cinematográfica (Chile) đối với video. Các giá trị hợp lệ cho thuộc tính này là: ccc14 – Từ 14 tuổi trở lên ccc18 – Từ 18 tuổi trở lên ccc18s – 18+ – contenido pornográfico ccc18v – 18+ - contenido excesivamente violento ccc6 – 6+ - Inconveniente para menores de 7 años cccTe – Todo espectador cccUnrated
contentDetails.contentRating.cceRating	string Mức phân loại của video theo Comissão de Classificação de Espect´culos của Bồ Đào Nha. Các giá trị hợp lệ cho thuộc tính này là: cceM12 – 12 cceM14 – 14 cceM16 – 16 cceM18 – 18 cceM4 – 4 cceM6 – 6 cceUnrated
contentDetails.contentRating.chfilmRating	string Mức phân loại của video ở Thuỵ Sĩ. Các giá trị hợp lệ cho thuộc tính này là: chfilm0 – 0 chfilm12 – 12 chfilm16 – 16 chfilm18 – 18 chfilm6 – 6 chfilmUnrated
contentDetails.contentRating.chvrsRating	string Mức phân loại của Hệ thống phân loại video gia đình Canada (CHVRS) đối với video. Các giá trị hợp lệ cho thuộc tính này là: chvrs14a – 14A chvrs18a – 18A chvrsE – E chvrsG – G chvrsPg – PG chvrsR – R chvrsUnrated
contentDetails.contentRating.cicfRating	string Mức phân loại của video theo Commission de Contrôle des Films (Bỉ). Các giá trị hợp lệ cho thuộc tính này là: cicfE – E cicfKntEna – KNT/ENA cicfKtEa – KT/EA cicfUnrated
contentDetails.contentRating.cnaRating	string Mức phân loại của video theo CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) của Romania. Các giá trị hợp lệ cho thuộc tính này là: cna12 – 12 cna15 – 15 cna18 – 18 cna18plus – Từ 18 tuổi trở lên cnaAp – AP cnaUnrated
contentDetails.contentRating.cncRating	string Hệ thống phân loại ở Pháp – Commission de classification cinematographique Các giá trị hợp lệ cho thuộc tính này là: cnc10 – 10 cnc12 – 12 cnc16 – 16 cnc18 – 18 cncE – E cncT – T cncUnrated
contentDetails.contentRating.csaRating	string Mức phân loại của video theo Conseil supérieur de l?audiovisuel của Pháp. Tổ chức này phân loại nội dung truyền hình. Các giá trị hợp lệ cho thuộc tính này là: csa10 – 10 csa12 – 12 csa16 – 16 csa18 – 18 csaInterdiction – Chặn csaT – T csaUnrated
contentDetails.contentRating.cscfRating	string Mức phân loại của video theo Ủy ban giám sát phân loại phim (CSCF) của Luxembourg. Các giá trị hợp lệ cho thuộc tính này là: cscf12 – 12 cscf16 – 16 cscf18 – 18 cscf6 – 6 cscf9 – 9 cscfA – A cscfAl – AL cscfUnrated
contentDetails.contentRating.czfilmRating	string Mức phân loại của video ở Cộng hoà Séc. Các giá trị hợp lệ cho thuộc tính này là: czfilm12 – 12 czfilm14 – 14 czfilm18 – 18 czfilmU – U czfilmUnrated
contentDetails.contentRating.djctqRating	string Mức phân loại của Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT – Brazil) đối với video. Các giá trị hợp lệ cho thuộc tính này là: djctq10 – 10 djctq12 – 12 djctq14 – 14 djctq16 – 16 djctq18 – 18 djctqL – L djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list Lý do giải thích vì sao video đó nhận được mức phân loại của DJCQT (Brazil).
contentDetails.contentRating.ecbmctRating	string Hệ thống phân loại ở Thổ Nhĩ Kỳ – Hội đồng Đánh giá và Phân loại của Bộ Văn hoá và Du lịch Các giá trị hợp lệ cho thuộc tính này là: ecbmct13a – 13A ecbmct13plus – Từ 13 tuổi trở lên ecbmct15a – 15A ecbmct15plus – Từ 15 tuổi trở lên ecbmct18plus – Từ 18 tuổi trở lên ecbmct7a – 7A ecbmct7plus – 7 trở lên ecbmctG – G ecbmctUnrated ecbmct6a – 6A ecbmct6plus – 6 trở lên ecbmct10a – 10A ecbmct10plus – 10+ ecbmct16plus – Từ 16 tuổi trở lên
contentDetails.contentRating.eefilmRating	string Mức phân loại của video ở Estonia. Các giá trị hợp lệ cho thuộc tính này là: eefilmK12 – K-12 eefilmK14 – K-14 eefilmK16 – K-16 eefilmK6 – K-6 eefilmL – L eefilmMs12 – MS-12 eefilmMs6 – MS-6 eefilmPere – Pere eefilmUnrated
contentDetails.contentRating.egfilmRating	string Mức phân loại của video ở Ai Cập. Các giá trị hợp lệ cho thuộc tính này là: egfilm18 – 18 egfilmBn – BN egfilmGn – GN egfilmUnrated
contentDetails.contentRating.eirinRating	string Mức phân loại Eirin (映倫) của video. Eirin là hệ thống phân loại của Nhật Bản. Các giá trị hợp lệ cho thuộc tính này là: eirinG – G eirinPg12 – PG-12 eirinR15plus – R15+ eirinR18plus – R18+ eirinUnrated
contentDetails.contentRating.fcbmRating	string Mức phân loại của video theo Hội đồng kiểm duyệt phim của Malaysia. Các giá trị hợp lệ cho thuộc tính này là: fcbm13 – 13 fcbm16 – 16 fcbm18 – 18 fcbm18pa – 18PA fcbm18pl – 18PL fcbm18sg – 18SG fcbm18sx – 18SX fcbmP12 – P12 fcbmP13 – P13 fcbmPg13 – PG-13 fcbmU – U fcbmUnrated
contentDetails.contentRating.fcoRating	string Mức phân loại của video theo Cục Quản lý phim, báo và bài viết của Hồng Kông. Các giá trị hợp lệ cho thuộc tính này là: fcoI – 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. Mức phân loại của video theo Centre national du cinéma et de l'image animé (Bộ Văn hoá Pháp). Các giá trị hợp lệ cho thuộc tính này là: fmoc10 – 10 fmoc12 – 12 fmoc16 – 16 fmoc18 – 18 fmocE – E fmocU – U fmocUnrated
contentDetails.contentRating.fpbRating	string Mức phân loại của video theo Hội đồng kiểm duyệt phim và ấn phẩm của Nam Phi. Các giá trị hợp lệ cho thuộc tính này là: fpb10 – 10 fpb1012Pg – 10-12PG fpb13 – 13 fpb16 – 16 fpb18 – 18 fpb79Pg – 7-9PG fpbA – A fpbPg – PG fpbUnrated fpbX18 – X18 fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[]	list Lý do giải thích tại sao video nhận được mức phân loại của FPB (Nam Phi).
contentDetails.contentRating.fskRating	string Mức phân loại của Freiwillige Selbstkontrolle der Filmwirtschaft (FSK – Đức) cho video. Các giá trị hợp lệ cho thuộc tính này là: fsk0 – FSK 0 fsk12 – FSK 12 fsk16 – FSK 16 fsk18 – FSK 18 fsk6 – FSK 6 fskUnrated
contentDetails.contentRating.grfilmRating	string Mức phân loại của video ở Hy Lạp. Các giá trị hợp lệ cho thuộc tính này là: grfilmE – E grfilmK – K grfilmK12 – K-12 grfilmK13 – K-13 grfilmK15 – K-15 grfilmK17 – K-17 grfilmK18 – K-18 grfilmUnrated
contentDetails.contentRating.icaaRating	string Mức phân loại của Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Tây Ban Nha) đối với video. Các giá trị hợp lệ cho thuộc tính này là: icaa12 – 12 icaa13 – 13 icaa16 – 16 icaa18 – 18 icaa7 – 7 icaaApta – APTA icaaUnrated icaaX – X
contentDetails.contentRating.ifcoRating	string Mức phân loại của video theo Irish Film Classification Office (IFCO – Ireland). Hãy xem trang web của IFCO để biết thêm thông tin. Các giá trị hợp lệ cho thuộc tính này là: ifco12 – 12 ifco12a – 12A ifco15 – 15 ifco15a – 15A ifco16 – 16 ifco18 – 18 ifcoG – G ifcoPg – PG ifcoUnrated
contentDetails.contentRating.ilfilmRating	string Mức phân loại của video ở Israel. Các giá trị hợp lệ cho thuộc tính này là: ilfilm12 – 12 ilfilm16 – 16 ilfilm18 – 18 ilfilmAa – AA ilfilmUnrated
contentDetails.contentRating.incaaRating	string Mức phân loại của INCAA (Instituto Nacional de Cine y Artes Audiovisuales – Argentina) đối với 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 của video theo Hội đồng phân loại phim Kenya. Các giá trị hợp lệ cho thuộc tính này là: kfcb16plus – 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 thuộc tính này là: kijkwijzer12 – 12 kijkwijzer14 – 14 kijkwijzer16 – 16 kijkwijzer18 – 18 kijkwijzer6 – 6 kijkwijzer9 – 9 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 (영상물등급위원회) đối với video. KMRB phân loại video ở Hàn Quốc. Các giá trị hợp lệ cho thuộc tính này là: kmrb12plus – 12세 이상 관람가 kmrb15plus – 15세 이상 관람가 kmrbAll – 전체관람가 kmrbR – 청소년 관람불가 kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string Mức phân loại của video theo Lembaga Sensor Film của Indonesia. Các giá trị hợp lệ cho thuộc tính này là: lsf13 – 13 lsf17 – 17 lsf21 – 21 lsfA – A lsfBo – BO lsfD – D lsfR – R lsfSu – SU lsfUnrated
contentDetails.contentRating.mccaaRating	string Mức phân loại của video theo Hội đồng phân loại phim theo độ tuổi của Malta. Các giá trị hợp lệ cho thuộc tính này là: mccaa12 – 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 được giới thiệu vào năm 2013. mccaa15 – 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 được giới thiệu vào năm 2013. mccaa18 – 18 mccaaPg – PG mccaaU – U mccaaUnrated
contentDetails.contentRating.mccypRating	string Mức phân loại của video theo Hội đồng truyền thông dành cho trẻ em và thanh thiếu niên của Viện phim Đan Mạch (Det Danske Filminstitut). Các giá trị hợp lệ cho 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 video tại Việt Nam – MCST Các giá trị hợp lệ cho thuộc tính này là: mcst0 – 0 mcst16plus – Từ 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 theo Cơ quan phát triển truyền thông (MDA) của Singapore, cụ thể là theo Hội đồng kiểm duyệt phim (BFC) của Singapore. Các giá trị hợp lệ cho thuộc tính này là: mdaG – G mdaM18 – M18 mdaNc16 – NC16 mdaPg – PG mdaPg13 – PG-13 mdaR21 – R21 mdaUnrated
contentDetails.contentRating.medietilsynetRating	string Mức phân loại của video theo Medietilsynet, Cơ quan quản lý truyền thông của Na Uy. Các giá trị hợp lệ cho thuộc tính này là: medietilsynet11 – 11 medietilsynet12 – 12 medietilsynet15 – 15 medietilsynet18 – 18 medietilsynet6 – 6 medietilsynet7 – 7 medietilsynet9 – 9 medietilsynetA – A medietilsynetUnrated
contentDetails.contentRating.mekuRating	string Mức phân loại của video theo Kansallinen Audiovisuaalinen Instituutti (Viện Âm thanh và hình ảnh quốc gia) của Phần Lan. Các giá trị hợp lệ cho thuộc tính này là: meku12 – 12 meku16 – 16 meku18 – 18 meku7 – 7 mekuS – S mekuUnrated
contentDetails.contentRating.mibacRating	string Mức phân loại của video theo Bộ Di sản, Hoạt động văn hoá và Du lịch (Ý). Các giá trị hợp lệ cho thuộc tính này là: mibacT mibacUnrated mibacVap mibacVm6 mibacVm12 mibacVm14 mibacVm18
contentDetails.contentRating.mocRating	string Mức phân loại của video theo Bộ Văn hoá (Colombia). Các giá trị hợp lệ cho thuộc tính này là: moc12 – 12 moc15 – 15 moc18 – 18 moc7 – 7 mocBanned – Bị cấm mocE – E mocT – T mocUnrated mocX – X
contentDetails.contentRating.moctwRating	string Mức phân loại của video theo Bộ Văn hoá Đài Loan (文化部). Các giá trị hợp lệ cho thuộc tính này là: moctwG – G moctwP – P moctwPg – PG moctwR – R 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) đối với video. Các giá trị hợp lệ cho thuộc tính này là: mpaaG – G mpaaNc17 – NC-17 mpaaPg – PG mpaaPg13 – PG-13 mpaaR – R mpaaUnrated
contentDetails.contentRating.mpaatRating	string Mức phân loại của Hiệp hội Điện ảnh Hoa Kỳ cho video giới thiệu và bản xem trước phim. Các giá trị hợp lệ cho thuộc tính này là: mpaatGb – GB (Green Band – Được phê duyệt cho mọi đối tượng) mpaatRb – RB (Nhóm tuổi đỏ – Dành cho độ tuổi từ 17 trở lên)
contentDetails.contentRating.mtrcbRating	string Mức phân loại của video theo Hội đồng phân loại và đánh giá phim và truyền hình (Philippines). Các giá trị hợp lệ cho thuộc tính 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 của video theo Cục phân loại quốc gia Maldives. Các giá trị hợp lệ cho thuộc tính này là: nbc12plus – 12+ nbc15plus – Từ 15 tuổi trở lên nbc18plus – Từ 18 tuổi trở lên nbc18plusr – 18+R nbcG – G nbcPg – PG nbcPu – PU nbcUnrated
contentDetails.contentRating.nfrcRating	string Mức phân loại của video theo Trung tâm Điện ảnh Quốc gia Bulgaria. Các giá trị hợp lệ cho thuộc tính này là: nfrcA – A nfrcB – B nfrcC – C nfrcD – D nfrcUnrated nfrcX – X
contentDetails.contentRating.nfvcbRating	string Mức phân loại của video theo Hội đồng kiểm duyệt phim và video quốc gia của Nigeria. Các giá trị hợp lệ cho thuộc tính này là: nfvcb12 – 12 nfvcb12a – 12A nfvcb15 – 15 nfvcb18 – 18 nfvcbG – G nfvcbPg – PG nfvcbRe – RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string Mức phân loại của video theo Nacionãlais Kino centrs (Trung tâm Điện ảnh Quốc gia Latvia). Các giá trị hợp lệ cho thuộc tính này là: nkclv12plus – 12+ nkclv18plus – Từ 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 Cơ quan phân loại phim và văn học (OFLC – New Zealand) đối với video. Các giá trị hợp lệ cho thuộc tính này là: oflcG – G oflcM – M oflcPg – PG oflcR13 – R13 oflcR15 – R15 oflcR16 – R16 oflcR18 – R18 oflcRp13 – RP13 oflcRp16 – RP16 oflcUnrated
contentDetails.contentRating.pefilmRating	string Mức phân loại của video ở Peru. Các giá trị hợp lệ cho thuộc tính này là: pefilm14 – 14 pefilm18 – 18 pefilmPg – PG pefilmPt – PT pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating	string Mức phân loại của video ở Venezuela. Các giá trị hợp lệ cho thuộc tính này là: resorteviolenciaA – A resorteviolenciaB – B 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) đối với video. Các giá trị hợp lệ cho thuộc tính này là: rtcA – A rtcAa – AA rtcB – B rtcB15 – B15 rtcC – C rtcD – D rtcUnrated
contentDetails.contentRating.rteRating	string Mức phân loại của video theo Raidió Teilifís Éireann của Ireland. Các giá trị hợp lệ cho thuộc tính này là: rteCh – CH rteGa – GA rteMa – MA rtePs – PS rteUnrated
contentDetails.contentRating.russiaRating	string Mức phân loại của Cơ quan đăng ký phim quốc gia thuộc Liên bang Nga (MKRF – Nga) đối với video. Các giá trị hợp lệ cho thuộc tính này là: russia0 – 0+ russia12 – 12+ russia16 – Từ 16 tuổi trở lên russia18 – Từ 18 tuổi trở lên russia6 – 6 trở lên russiaUnrated
contentDetails.contentRating.skfilmRating	string Mức phân loại của video ở Slovakia. Các giá trị hợp lệ cho thuộc tính này là: skfilmG – G skfilmP2 – P2 skfilmP5 – P5 skfilmP8 – P8 skfilmUnrated
contentDetails.contentRating.smaisRating	string Mức phân loại của video ở Iceland. Các giá trị hợp lệ cho thuộc tính này là: smais12 – 12 smais14 – 14 smais16 – 16 smais18 – 18 smais7 – 7 smaisL – L smaisUnrated
contentDetails.contentRating.smsaRating	string Mức phân loại của video theo Statens medieråd (Hội đồng truyền thông quốc gia của Thuỵ Điển). Các giá trị hợp lệ cho thuộc tính này là: smsa11 – 11 smsa15 – 15 smsa7 – 7 smsaA – Mọi độ tuổi smsaUnrated
contentDetails.contentRating.tvpgRating	string Mức phân loại theo Hướng dẫn dành cho cha mẹ về chương trình truyền hình (TVPG) của video. Các giá trị hợp lệ cho thuộc tính này là: 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 có giới hạn về độ tuổi. Các giá trị hợp lệ cho thuộc tính 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 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 thuộc tính này.
status	object Đối tượng status chứa thông tin về trạng thái tải lên, xử lý và quyền riêng tư của video.
status.uploadStatus	string Trạng thái của video đã tải lên. Các giá trị hợp lệ cho thuộc tính này là: 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 quá trình tải lên không thành công. Các giá trị hợp lệ cho thuộc tính này là: 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. Các 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 thuộc tính này là: private public unlisted
status.publishAt	datetime Ngày và giờ xuất bản video theo lịch. Bạn chỉ có thể đặt chế độ này nếu trạng thái quyền riêng tư của video là riêng tư. Giá trị được chỉ định ở định dạng ISO 8601. Xin lưu ý thêm hai điểm sau đây về hành vi của thuộc tính này: 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 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 đó, hiệu quả của việc đặt thuộc tính status.publishAt thành ngày và giờ trong quá khứ cũng giống như hiệu quả của 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ệ cho thuộc tính này là: creativeCommon youtube
status.embeddable	boolean Giá trị này cho biết liệu có thể nhúng video trên một trang web khác hay không.
status.publicStatsViewable	boolean Giá trị này cho biết liệu số liệu thống kê mở rộng của video trên trang xem của video có thể xem công khai hay không. Theo mặc định, những số liệu thống kê đó có thể xem được và các số liệu thống kê như số lượt xem và điểm xếp hạng của video vẫn sẽ xuất hiện công khai ngay cả khi bạn đặt giá trị của thuộc tính này thành false.
status.madeForKids	boolean Giá trị này cho biết liệu video có được chỉ định là video dành cho trẻ em hay không và chứa trạng thái "dành cho trẻ em" hiện tại của video. Ví dụ: trạng thái có thể được xác định dựa trên giá trị của thuộc tính selfDeclaredMadeForKids. 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 sự kiện phát trực tiếp 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à video hướng tới trẻ em. Trong yêu cầu videos.list, giá trị thuộc tính chỉ được trả về nếu chủ sở hữu kênh đã cho phép yêu cầu API.
status.containsSyntheticMedia	boolean Trong yêu cầu videos.insert hoặc videos.update, thuộc tính này cho phép chủ sở hữu kênh công bố rằng video có chứa nội dung Đã bị chỉnh sửa hoặc Nhân tạo (A/S) trông giống như thật. Tìm hiểu thêm về các chính sách của YouTube liên quan đến nội dung sửa chữa và bảo dưỡng. Ví dụ về nội dung A/S bao gồm những video: Có hình ảnh người thật có vẻ như nói và làm điều gì đó, nhưng trên thực thế là họ không làm như vậy Chỉnh sửa cảnh quay của một sự kiện hoặc địa điểm có thật Tạo ra một cảnh trông giống thật nhưng không thực sự xảy ra
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. Kể từ ngày 31 tháng 3 năm 2025, đối với video ngắn, viewCount sẽ trả về số lần một video ngắn bắt đầu phát hoặc phát lại (không có yêu cầu về thời gian xem tối thiểu).
statistics.likeCount	unsigned long Số người dùng đã cho biết rằng họ thích video đó.
statistics.dislikeCount	unsigned long Lưu ý: Tài sản statistics.dislikeCount đã được đặt ở chế độ riêng tư kể từ ngày 13 tháng 12 năm 2021. Điều này có nghĩa là tài sản chỉ được đưa vào phản hồi API nếu yêu cầu API được chủ sở hữu video xác thực. Hãy xem nhật ký sửa đổi để biết thêm thông tin. Số người dùng đã cho biết rằng họ không thích video.
statistics.favoriteCount	unsigned long Lưu ý: Thuộc tính này không còn được dùng nữa. Việc ngừng sử dụng sẽ có hiệu lực từ ngày 28 tháng 8 năm 2015. Giá trị của thuộc tính này hiện luôn được đặt thành 0.
statistics.commentCount	unsigned long Số bình luận cho video.
paidProductPlacementDetails	object Đối tượng paidProductPlacementDetails chứa thông tin về nội dung lồng ghép sản phẩm có tính phí trong video.
paidProductPlacementDetails.hasPaidProductPlacement	boolean Đặt thành true nếu nội dung sử dụng hoạt động lồng ghép sản phẩm có tính phí. Giá trị mặc định là false.
player	object Đối tượng player chứa thông tin mà bạn sẽ 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 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 maxHeight và/hoặc maxWidth. Nếu không xác định được tỷ lệ khung hình của video, 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 thông số maxHeight và/hoặc maxWidth và tỷ lệ khung hình của video đã được xác định.
player.embedWidth	long Chiều rộng của trình phát được nhúng được trả về trong thuộc tính player.embedHtml. Thuộc tính này chỉ được trả về nếu yêu cầu chỉ định một giá trị cho các thông số maxHeight và/hoặc maxWidth và tỷ lệ khung hình của video đã được xác định.
topicDetails	object Đối tượng topicDetails chứa thông tin về các chủ đề liên quan đến video. Lưu ý quan trọng: Hãy xem định nghĩa của các thuộc tính topicDetails.relevantTopicIds[] và topicDetails.topicIds[] cũng như nhật ký sửa đổi để biết thêm thông tin chi tiết về các thay đổi sắp tới liên quan đến mã chủ đề.
topicDetails.topicIds[]	list Lưu ý quan trọng: Thuộc tính này không đượ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 và mọi chủ đề liên kết với một video hiện được trả về bằng giá trị thuộc tính topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[]	list Danh sách mã chủ đề có liên quan đến video. Thuộc tính này không còn được dùng nữa kể từ ngày 10 tháng 11 năm 2016. Chúng tôi sẽ hỗ trợ API 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 không còn được dùng nữa, mã chủ đề bắt đầu hoạt động theo cách khác kể từ ngày 27 tháng 2 năm 2017. Vào thời điểm đó, YouTube bắt đầu trả về một nhóm nhỏ 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ủ đề về â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 Nhạc độc lập /m/03_d0 Nhạc Jazz /m/028sqc Nhạc Châu Á /m/0g293 Nhạc Mỹ Latinh /m/064t9 Nhạc Pop /m/06cqb Nhạc Reggae /m/06j6l Giai điệu và nhạc Blues /m/06by7 Nhạc Rock /m/0gywn Nhạc Soul Chủ đề về 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ử chủ đề â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ủ đề về 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 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ủ đề gốc) /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ề phong cách sống /m/019_rr Lối sống (chủ đề gốc) /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 Vẻ hấp dẫn về thể chất [Vẻ đẹp] /m/07c1v Công nghệ /m/07bxq Du lịch /m/07yv9 Phương tiện vận tải Chủ đề xã hội /m/098wr Xã hội (chủ đề gốc) /m/09s1f Doanh nghiệp /m/0kt51 Sức khỏe /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 URL của Wikipedia cung cấp thông tin mô tả tổng quan về nội dung của video.
recordingDetails	object Đối tượng recordingDetails chứa thông tin về vị trí, ngày và địa chỉ nơi quay video.
recordingDetails.locationDescription	string Thuộc tính này không được dùng nữa kể từ ngày 1 tháng 6 năm 2017. Vui lòng xem thông báo về việc không dùng nữa để biết thêm thông tin chi tiết. Nội dung mô tả bằng văn bản về địa điểm quay video.
recordingDetails.location	object Thông tin vị trí địa lý liên kết với video. Xin lưu ý rằng giá trị thuộc tính con xác định vị trí mà chủ sở hữu video muốn liên kết với video. Bạn có thể chỉnh sửa, tìm kiếm giá trị này trên video công khai và giá trị này có thể hiển thị cho người dùng đối với video công khai.
recordingDetails.location.latitude	double Thuộc tính này không được dùng nữa kể từ ngày 1 tháng 6 năm 2017. Vui lòng xem thông báo về việc không dùng nữa để biết thêm thông tin chi tiết. Vĩ độ tính bằng độ.
recordingDetails.location.longitude	double Thuộc tính này không được dùng nữa kể từ ngày 1 tháng 6 năm 2017. Vui lòng xem thông báo về việc không dùng nữa để biết thêm thông tin chi tiết. Kinh độ tính bằng độ.
recordingDetails.location.altitude	double Thuộc tính này không còn được dùng nữa kể từ ngày 9 tháng 7 năm 2018. Vui lòng xem thông báo về việc không dùng nữa để biết thêm thông tin chi tiết. Độ cao trên hình elip tham chiếu, tính bằng mét.
recordingDetails.recordingDate	datetime Ngày và giờ quay video. Giá trị được chỉ định ở định dạng ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails	object Đối tượng fileDetails chứa thông tin về tệp video đã tải lên YouTube, bao gồm độ phân giải, thời lượng, bộ mã hoá và giải mã âm thanh và video, tốc độ bit của luồng, v.v. Chỉ chủ sở hữu video mới có thể truy xuất dữ liệu này. Đối tượng fileDetails sẽ chỉ được trả về nếu thuộc tính processingDetails.fileAvailability có giá trị là available.
fileDetails.fileName	string Tên của tệp đã tải lên. Trường này sẽ xuất hiện bất kể bạn tải tệp video hay một loại tệp khác lên.
fileDetails.fileSize	unsigned long Kích thước của tệp đã tải lên tính bằng byte. Trường này sẽ xuất hiện bất kể bạn tải tệp video hay một loại tệp khác lên.
fileDetails.fileType	string Loại tệp được tải lên theo như phát hiện của công cụ xử lý video của YouTube. Hiện tại, YouTube chỉ xử lý tệp video, nhưng trường này vẫn xuất hiện cho dù bạn tải tệp video hay một loại tệp khác lên. Các giá trị hợp lệ cho thuộc tính này là: archive – Tệp là tệp lưu trữ, chẳng hạn như tệp lưu trữ .zip. audio – Tệp thuộc một loại tệp âm thanh đã biết, chẳng hạn như tệp .mp3. document – Tệp 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 là tệp hình ảnh, chẳng hạn như hình ảnh .jpeg. other – Tệp là một loại tệp 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 là một 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 là 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, chỉ đị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 mỗi giây.
fileDetails.videoStreams[].rotation	string Số độ mà YouTube cần xoay nội dung nguồn gốc để hiển thị video đúng cách. Các giá trị hợp lệ cho thuộc tính này là: 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 – Video cần được xoay theo một cách không quan trọng nào đó. upsideDown – Video cần được xoay ngược.
fileDetails.videoStreams[].vendor	string Giá trị nhận dạng duy nhất một nhà cung cấp video. Thông thường, giá trị này là mã nhà cung cấp gồm 4 chữ cái.
fileDetails.audioStreams[]	list Danh sách các luồng âm thanh có trong tệp video đã tải lên. Mỗi mục trong danh sách chứa siêu dữ liệu chi tiết về một luồng âm thanh.
fileDetails.audioStreams[].channelCount	unsigned integer Số lượng kênh âm thanh mà luồng chứa.
fileDetails.audioStreams[].codec	string Bộ mã hoá và giải mã âm thanh mà luồng sử dụng.
fileDetails.audioStreams[].bitrateBps	unsigned long Tốc độ bit của luồng âm thanh, tính bằng bit mỗi giây.
fileDetails.audioStreams[].vendor	string Giá trị nhận dạng duy nhất một nhà cung cấp video. Thông thường, giá trị này là mã nhà cung cấp gồm 4 chữ cái.
fileDetails.durationMs	unsigned long Thời lượng của video đã tải lên tính bằng mili giây.
fileDetails.bitrateBps	unsigned long Tốc độ bit kết hợp (video và âm thanh) của tệp video đã tải lên, tính bằng bit mỗi giây.
fileDetails.creationTime	string Ngày và giờ tạo tệp video được tải lên. Giá trị được chỉ định ở định dạng ISO 8601. Hiện tại, chúng tôi hỗ trợ các định dạng ISO 8601 sau: Chỉ ngày: YYYY-MM-DD Thời gian ngây thơ: 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 chứa thông tin về tiến trình xử lý tệp video đã tải lên của YouTube. Các thuộc tính trong đối tượng này cho biết trạng thái xử lý hiện tại và thời gian ước tính còn lại cho đến khi YouTube xử lý xong video. Phần này cũng cho biết liệu video có các loại dữ liệu hoặc nội dung khác nhau (chẳng hạn như thông tin chi tiết về tệp hoặc hình thu nhỏ) hay không. Đối tượng processingProgress được thiết kế để được thăm dò ý kiến để video được tải lên có thể theo dõi tiến trình mà YouTube đã thực hiện trong quá trình xử lý tệp video đã tải lên. Chỉ chủ sở hữu video mới có thể truy xuất dữ liệu này.
processingDetails.processingStatus	string Trạng thái xử lý của video. Giá trị này cho biết liệu YouTube có thể xử lý video hay không hoặc video có đang được xử lý hay không. Các giá trị hợp lệ cho thuộc tính này là: failed – Không xử lý được video. Xem ProcessingFailureReason. processing – Video đang được xử lý. Xem ProcessingProgress. succeeded – Video đã được xử lý thành công. terminated – Không còn thông tin xử lý.
processingDetails.processingProgress	object Đối tượng processingProgress chứa thông tin về tiến trình xử lý video của YouTube. Các giá trị này chỉ thực sự có liên quan nếu trạng thái xử lý của video là processing.
processingDetails.processingProgress.partsTotal	unsigned long Số phần cần xử lý ước tính cho video. Số liệu này có thể được cập nhật bằng số liệu ước tính chính xác hơn trong khi YouTube xử lý video.
processingDetails.processingProgress.partsProcessed	unsigned long Số phần 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 tính có thể tăng mà số lượng phần đã xử lý không tăng tương ứng, nên tiến trình được tính toán có thể giảm định kỳ trong khi YouTube xử lý video.
processingDetails.processingProgress.timeLeftMs	unsigned long Thời gian ước tính (tính bằng mili giây) mà YouTube cần để hoàn tất quá trình xử lý video.
processingDetails.processingFailureReason	string Lý do 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 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 phân phố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 một video bằng cách yêu cầu phần fileDetails trong yêu cầu videos.list().
processingDetails.processingIssuesAvailability	string Giá trị này cho biết liệu công cụ xử lý video có tạo ra các đề xuất có thể cải thiện khả năng xử lý video của YouTube, cảnh báo giải thích các vấn đề về việc xử lý video hay lỗi gây ra vấn đề về việc xử lý video hay không. Bạn có thể truy xuất các đề xuất này bằng cách yêu cầu phần suggestions trong yêu cầu videos.list().
processingDetails.tagSuggestionsAvailability	string Giá trị này cho biết liệu có đề xuất từ khoá (thẻ) cho video hay không. Bạn có thể thêm thẻ vào siêu dữ liệu của video để giúp người dùng khác dễ dàng tìm thấy video đó. Bạn có thể truy xuất các đề xuất này bằng cách yêu cầu phần suggestions trong yêu cầu videos.list().
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 tạo cho video hay chưa.
suggestions	object Đối tượng suggestions đóng gói các đề xuất xác định cơ hội cải thiện chất lượng video hoặc siêu dữ liệu cho video đã tải lên. Chỉ chủ sở hữu video mới có thể truy xuất dữ liệu này. Đối tượng suggestions sẽ chỉ được trả về nếu thuộc tính processingDetails.tagSuggestionsAvailability hoặc thuộc tính processingDetails.editorSuggestionsAvailability có giá trị là available.
suggestions.processingErrors[]	list Danh sách lỗi khiến YouTube không thể xử lý thành công video bạn tải lên. Những lỗi này cho biết rằng, bất kể trạng thái xử lý hiện tại của video là gì, thì cuối cùng, trạng thái đó gần như chắc chắn sẽ là failed. Các giá trị hợp lệ cho thuộc tính này là: 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ông phải video khác. projectFile – Tệp dự án phim (ví dụ: dự án Microsoft Windows Movie Maker).
suggestions.processingWarnings[]	list Danh sách lý do khiến YouTube có thể gặp khó khăn trong việc chuyển mã video đã tải lên hoặc có thể dẫn đến việc chuyển mã không chính xác. Những cảnh báo này được tạo trước khi YouTube thực sự xử lý tệp video đã tải lên. Ngoài ra, các giá trị này xác định những vấn đề không nhất thiết cho biết quá trình xử lý video sẽ không thành công nhưng vẫn có thể gây ra các vấn đề như vấn đề đồng bộ hoá, hiện tượng video bị méo hoặc thiếu kênh âm thanh. Các giá trị hợp lệ cho thuộc tính này là: hasEditlist – Hiện không hỗ trợ tính năng chỉnh sửa danh sách. inconsistentResolution – Độ phân giải của vùng chứa và luồng xung đột. problematicAudioCodec – Đã sử dụng bộ mã hoá và giải mã âm thanh được biết là gây ra sự cố. problematicVideoCodec – Bộ mã hoá và giải mã video được biết là gây ra sự cố. unknownAudioCodec – Bộ mã hoá và giải mã âm thanh không được nhận dạng, có thể quá trình chuyển mã sẽ không thành công. unknownContainer – Định dạng tệp không được nhận dạng, có thể không chuyển mã được. unknownVideoCodec – Bộ mã hoá và giải mã video không được nhận dạng, có thể quá trình chuyển mã sẽ không thành công.
suggestions.processingHints[]	list Danh sách các đề xuất có thể giúp YouTube xử lý video hiệu quả hơn. Các giá trị hợp lệ cho thuộc tính này là: nonStreamableMov – Tệp MP4 không thể truyền trực tuyến, điều này sẽ làm chậm quá trình xử lý. sendBestQualityVideo – Có thể có phiên bản video chất lượng cao hơn.
suggestions.tagSuggestions[]	list Danh sách các thẻ từ khoá có thể thêm vào siêu dữ liệu của video để tăng khả năng người dùng tìm thấy video của bạn khi tìm kiếm hoặc duyệt xem trên YouTube.
suggestions.tagSuggestions[].tag	string Thẻ từ khoá được đề xuất cho video.
suggestions.tagSuggestions[].categoryRestricts[]	list Một nhóm danh mục video mà thẻ này có liên quan. Bạn có thể sử dụng thông tin này để hiển thị các đề xuất thẻ phù hợp dựa trên danh mục video mà người tải video lên liên kết với video đó. Theo mặc định, các đề xuất thẻ đều phù hợp với tất cả danh mục nếu không có quy tắ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 không phát ra âm thanh và có thể được 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ẻ không chính xác và có thể được chỉnh sửa. videoCrop – Có thể cắt bớt lề (mặt mờ) được phát hiện xung quanh bức ảnh. videoStabilize – Video có vẻ bị rung và có thể được ổn định.
liveStreamingDetails	object Đối tượng liveStreamingDetails chứa siêu dữ liệu về một sự kiện phát trực tiếp video. Đối tượng này sẽ chỉ xuất hiện trong tài nguyên video nếu video là một sự kiện phát trực tiếp sắp diễn ra, đang diễn ra hoặc đã kết thúc.
liveStreamingDetails.actualStartTime	datetime Thời gian thực tế mà chương trình phát sóng bắt đầu. Giá trị được chỉ định ở định dạng ISO 8601. Bạn sẽ không thấy giá trị này cho đến khi sự kiện phát sóng bắt đầu.
liveStreamingDetails.actualEndTime	datetime Thời điểm chương trình phát sóng thực sự kết thúc. Giá trị được chỉ định ở định dạng ISO 8601. Bạn sẽ không thấy giá trị này cho đến khi sự kiện phát sóng kết thúc.
liveStreamingDetails.scheduledStartTime	datetime Thời gian bắt đầu phát sóng theo lịch. Giá trị được chỉ định ở định dạng ISO 8601.
liveStreamingDetails.scheduledEndTime	datetime Thời gian dự kiến kết thúc chương trình phát sóng. Giá trị được chỉ định ở định dạng ISO 8601. Nếu giá trị này trống hoặc không có thuộc tính, thì thông báo truyền tin sẽ được lên lịch tiếp tục vô thời hạn.
liveStreamingDetails.concurrentViewers	unsigned long Số người xem hiện đang xem sự kiện phát trực tiếp. Thuộc tính này và giá trị của thuộc tính sẽ xuất hiện nếu chương trình phát sóng có người xem hiện tại và chủ sở hữu chương trình phát sóng chưa ẩn số lượt xem của video. Xin lưu ý rằng YouTube sẽ ngừng theo dõi số người xem đồng thời của một sự kiện phát trực tiếp khi sự kiện đó kết thúc. Do đó, thuộc tính này sẽ không xác định số người xem video lưu trữ của một sự kiện phát trực tiếp đã kết thúc. Số người xem đồng thời mà YouTube Data API trả về có thể khác với số người xem đồng thời đã được xử lý và loại bỏ nội dung rác thông qua YouTube Analytics. Tìm hiểu thêm về các chỉ số của sự kiện phát trực tiếp trong Trung tâm trợ giúp của YouTube.
liveStreamingDetails.activeLiveChatId	string Mã của cuộc trò chuyện trực tiếp đang hoạt động được đính kèm vào video này. Trường này chỉ được điền nếu video là sự kiện phát trực tiếp đang diễn ra và có tính năng trò chuyện trực tiếp. Sau khi sự kiện phát trực tiếp kết thúc, trường này sẽ bị xoá và cuộc trò chuyện trực tiếp sẽ đóng lại. Đối với các sự kiện phát trực tiếp liên tục, mã cuộc trò chuyện trực tiếp sẽ không còn liên kết với video này mà sẽ liên kết với video mới đang hiển thị trên trang liên tục.
localizations	object Đối tượng localizations chứa bản dịch siêu dữ liệu của video.
localizations.(key)	object Ngôn ngữ của văn bản đã bản địa hoá liên kết với giá trị khoá. Giá trị này là một chuỗi chứa mã ngôn ngữ BCP-47.
localizations.(key).title	string Tiêu đề video đã được bản địa hoá.
localizations.(key).description	string Nội dung mô tả video đã được bản địa hoá.