Videos

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 đã đánh giá cho một danh sách video được chỉ định. Thử ngay.
list
Trả về danh sách video khớp với các tham số của yêu cầu API. Thử ngay.
batchGetStats
Lấy danh sách số liệu thống kê về video khớp với các tham số của yêu cầu API. Thử ngay.
chèn
Tải video lên YouTube và đặt siêu dữ liệu của video (không bắt buộc).
update
Cập nhật siêu dữ liệu của video. Thử ngay.
xóa
Xoá một video trên YouTube. Thử ngay.
tỷ lệ
Thêm lượt thích hoặc không thích cho một video hoặc xoá lượt thích/không thích khỏi một video. Thử ngay.
reportAbuse
Báo cáo video có nội dung vi phạm. Thử ngay.

Cách trình bày tài nguyên

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

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

Thuộc tính

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

Thuộc tính
kind string
Xác định loại tài nguyên của 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 duy nhất mà YouTube dùng để xác định video.
snippet object
Đối tượng snippet chứa thông tin chi tiết cơ bản về video, chẳng hạn như tiêu đề, nội dung mô tả và danh mục.
snippet.publishedAt datetime
Ngày và giờ xuất bản video. Thời gian này có thể khác với thời gian tải video lên. Ví dụ: nếu một video được tải lên ở chế độ riêng tư rồi sau đó chuyển sang chế độ công khai, thì thuộc tính này sẽ chỉ định thời điểm video được chuyển sang chế độ công khai.

Có một số trường hợp đặc biệt:
  • Nếu 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 sẽ chỉ định ngày và giờ video được tải 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 của video.
  • Nếu video được tải lên dưới dạng video chỉ dành cho hội viên, thì giá trị thuộc tính sẽ chỉ định ngày và giờ video được tải lên.
Giá trị được chỉ định ở định dạng ISO 8601.
snippet.channelId string
Mã nhận dạng mà YouTube dùng để xác định riêng biệt kênh đã tải video lên. Giá trị này có thể thay đổi theo thời gian, chẳng hạn như khi một video được chỉ định lại cho một kênh khác (ví dụ: kênh chủ đề hoặc kênh nghệ sĩ).
snippet.title string
Tiêu đề của video. Giá trị thuộc tính có độ dài tối đa là 100 ký tự và có thể chứa tất cả các ký tự UTF-8 hợp lệ ngoại trừ < và >. Bạn phải đặt giá trị cho thuộc tính này nếu gọi phương thức videos.update và đang cập nhật phần snippet của tài nguyên video.
snippet.description string
Nội dung mô tả video. Giá trị của thuộc tính có độ dài tối đa là 5.000 byte và có thể chứa tất cả các ký tự UTF-8 hợp lệ, ngoại trừ < và >.

Bạn có thể tạo phân cảnh video bằng cách thêm dấu thời gian được định dạng (ví dụ: 00:00) vào văn bản mô tả.
snippet.thumbnails 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 video (hoặc tài nguyên tham chiếu đến video, chẳng hạn như mục trong danh sách phát hoặc kết quả tìm kiếm) có chiều rộng 120px và chiều cao 90px. Hình thu nhỏ mặc định cho kênh có chiều rộng 88 pixel và chiều cao 88 pixel.
  • medium – Phiên bản có độ phân giải cao hơn của hình thu nhỏ. Đối với video (hoặc tài nguyên đề cập đế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 px và chiều cao 240 px.
  • high – Phiên bản có độ phân giải cao của hình thu nhỏ. Đố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 có độ phân giải cao hơn cả phiên bản high của hình thu nhỏ. Hình ảnh này xuất hiện ở một số video và các tài nguyên khác có liên quan đến video, chẳng hạn như các mục trong danh sách phát hoặc kết quả tìm kiếm. Hình ảnh này có chiều rộng 640 px và chiều cao 480 px.
  • maxres – Phiên bản có độ phân giải cao của hình thu nhỏ. Kích thước hình ảnh này được 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ư 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.
  • fhd – Phiên bản độ nét cao đầy đủ (1080p) của hình thu nhỏ. Kích thước hình ảnh này được hỗ trợ cho một số video. Hình ảnh này có chiều rộng 1920px và chiều cao 1080px.
  • qhd – Phiên bản Quad HD (1440p / 2K) của hình thu nhỏ. Kích thước hình ảnh này được hỗ trợ cho một số video. Hình ảnh này có chiều rộng 2560px và chiều cao 1440px.
  • uhd – Phiên bản có độ phân giải cực cao (4K) của hình thu nhỏ. Kích thước hình ảnh này được hỗ trợ cho một số video. Hình ảnh này có chiều rộng 3840px và chiều cao 2160px.
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 chứa video.
snippet.tags[] list
Danh sách các thẻ từ khoá liên kết với video. Thẻ có thể chứa dấu cách. Giá trị thuộc tính có độ dài tối đa là 500 ký tự. Hãy lưu ý những quy tắc sau đây về cách tính giới hạn ký tự:
  • 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ế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 đặt trong dấu ngoặc kép và dấu ngoặc kép sẽ được tính vào giới hạn ký tự. Vì vậy, đố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 video có phải là một sự kiện phát sóng trực tiếp sắp diễn ra/đang diễn ra hay không. Giá trị của thuộc tính này là none nếu video không phải là một chương trình phát sóng trực tiếp sắp diễn ra/đang 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 các thuộc tính snippet.title và snippet.description của tài nguyên video.
snippet.localized object
Đối tượng snippet.localized chứa tiêu đề và nội dung mô tả đã bản địa hoá cho video hoặc tiêu đề bằng ngôn ngữ mặc định cho siêu dữ liệu của video.
  • Văn bản đã bản địa hoá sẽ được trả về trong đoạn trích 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 sẽ được trả về nếu bạn không chỉ định giá trị tham số hl hoặc bạn có 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 này 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á tiêu đề theo ngôn ngữ.
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à chỉ báo về việc video có phụ đề hay không.
contentDetails.duration string
Thời lượng của video. Giá trị của 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à dưới một giờ, thời lượng sẽ có định dạng PT#M#S, trong đó các chữ cái PT cho biết giá trị chỉ định một khoảng thời gian, còn các chữ cái M và S lần lượt là độ 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ị PT15M33S cho biết video dài 15 phút 33 giây.

Nếu video có thời lượng ít nhất là 1 giờ, thì thời lượng sẽ ở định dạng PT#H#M#S, trong đó # đứng trước chữ H cho biết thời lượng của video tính bằng giờ và tất cả thông tin khác đều giống như mô tả ở trên. Nếu video dài ít nhất một ngày, thì các chữ cái P và T sẽ được phân tách và định dạng của giá trị 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ó ở độ nét 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 nơi người dùng có thể (hoặc không thể) xem một 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 nơi video có thể xem được. Nếu thuộc tính này xuất hiện và một quốc gia không có trong giá trị của thuộc tính, thì video sẽ bị chặn xuất hiện ở quốc gia đó. Nếu thuộc tính này xuất hiện và chứa một danh sách trống, thì video sẽ bị chặn ở tất cả các quốc gia.
contentDetails.regionRestriction.blocked[] list
Danh sách mã vùng xác định các quốc gia nơi video bị chặn. Nếu thuộc tính này xuất hiện và một quốc gia không có trong giá trị của thuộc tính, thì video có thể xem được ở quốc gia đó. Nếu thuộc tính này có trong video và chứa một danh sách trống, thì video đó có thể xem được ở mọi quốc gia.
contentDetails.contentRating object
Chỉ định điểm xếp hạng mà video nhận được theo nhiều hệ thống xếp hạng.
contentDetails.contentRating.acbRating string
Mức phân loại của video theo Uỷ ban phân loại Úc (ACB) hoặc Cơ quan truyền thông và truyền thông Úc (ACMA). Hệ thống phân loại của ACMA được dùng để phân loại chương trình truyền hình dành cho trẻ em.

Các giá trị hợp lệ cho thuộc tính này là:
  • 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) dưới 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 do Autorità per le Garanzie nelle Comunicazioni (AGCOM) của Ý đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • agcomT – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
Mức phân loại Anatel (Asociación Nacional de Televisión) của video dành cho 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 video theo Hội đồng phân loại phim của Anh (BBFC).

Các giá trị hợp lệ cho thuộc tính này là:
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 – 18 tuổi
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
Mức phân loại của video do Hội đồng kiểm duyệt phim và video của Thái Lan đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18 tuổi
  • bfvc20 – 20
  • bfvcB – B
  • bfvcE – E
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
Mức phân loại của video do Hội đồng phân loại nội dung nghe nhìn của Áo (Bundesministerium für Unterricht, Kunst und Kultur) đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14+
  • bmukk16 – 16+
  • bmukk6 – 6+
  • bmukk8 – 8+
  • bmukkAa – Không hạn chế
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Hệ thống phân loại dành cho truyền hình Canada – Hệ thống phân loại truyền hình Canada Mức phân loại của video do Uỷ ban Viễn thông và Phát thanh Truyền hình Canada (CRTC) đưa ra cho các chương trình phát sóng bằng tiếng Anh tại Canada. Để biết thêm thông tin, hãy xem trang web của Hội đồng Tiêu chuẩn Phát sóng Canada.

Các giá trị hợp lệ cho thuộc tính này là:
  • catv14plus – 14+
  • catv18plus – 18+
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
Mức phân loại của video do Uỷ ban Phát thanh truyền hình và Viễn thông Canada (CRTC) đưa ra cho các chương trình phát sóng bằng tiếng Pháp ở Canada. Để biết thêm thông tin, hãy xem trang web của Hội đồng Tiêu chuẩn Phát sóng Canada.

Các giá trị hợp lệ cho thuộc tính này là:
  • catvfr13plus – 13+
  • catvfr16plus – 16+
  • catvfr18plus – 18+
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Mức phân loại của video theo Central Board of Film Certification (CBFC – Ấn Độ).

Các giá trị hợp lệ cho thuộc tính này là:
  • 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 video theo Consejo de Calificación Cinematográfica (Chile).

Các giá trị hợp lệ cho thuộc tính này là:
  • ccc14 – 14+
  • ccc18 – 18+
  • 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 video của Comissão de Classificação de Espect´culos (Uỷ ban phân loại nội dung giải trí) của Bồ Đào Nha.

Giá trị hợp lệ cho thuộc tính này là:
  • cceM12 – 12
  • cceM14 – 14
  • cceM16 – 16
  • cceM18 – 18 tuổi
  • 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 tuổi
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Mức phân loại của video theo Hệ thống phân loại video gia đình của Canada (CHVRS).

Các giá trị hợp lệ cho thuộc tính này là:
  • 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ỉ).

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 video của CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) tại Romania.

Các giá trị hợp lệ cho thuộc tính này là:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18 tuổi
  • cna18plus – 18+
  • 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 tuổi
  • 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, cơ quan phân loại nội dung phát sóng.

Các giá trị hợp lệ cho thuộc tính này là:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18 tuổi
  • csaInterdiction – Ngăn chặn
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
Mức phân loại của video do Commission de surveillance de la classification des films (CSCF) của Luxembourg đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • 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 tại Cộng hoà Séc.

Thuộc tính này có thể có các giá trị sau:
  • 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) dành cho 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 tuổi
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Lý do giải thích tại sao video nhận được mức phân loại của DJCQT (Brazil).
contentDetails.contentRating.ecbmctRating 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 – 13+
  • ecbmct15a – 15A
  • ecbmct15plus – 15+
  • ecbmct18plus – 18+
  • ecbmct7a – 7A
  • ecbmct7plus – 7+
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6+
  • ecbmct10a – 10A
  • ecbmct10plus – 10+
  • ecbmct16plus – 16+
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 tuổi
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
Mức phân loại của video theo Eirin (映倫). 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 do Cục kiểm duyệt phim của Malaysia đưa ra.

Giá trị hợp lệ cho thuộc tính này là:
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18 tuổi
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
Mức phân loại của video do Văn phòng Quản lý Phim, Báo và Bài viết của Hồng Kông đưa ra.

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òn được dùng nữa kể từ ngày 2 tháng 11 năm 2015. Thay vào đó, hãy sử dụng thuộc tính contentDetails.contentRating.cncRating.

Mức phân loại của video theo Centre national du cinéma et de l'image animé (Bộ Văn hoá Pháp).

Các giá trị hợp lệ cho thuộc tính này là:
  • 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 do Hội đồng Xuất bản và Điện ảnh Nam Phi đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • 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 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 video do Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – Tây Ban Nha) đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • icaa12 – 12
  • icaa13 – 13
  • icaa16 – 16
  • icaa18 – 18 tuổi
  • icaa7 – 7
  • icaaApta – APTA
  • icaaUnrated
  • icaaX – X
contentDetails.contentRating.ifcoRating string
Mức phân loại của video theo Văn phòng phân loại phim Ireland (IFCO – Ireland). Hãy truy cập vào 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 tuổi
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Mức phân loại của video theo INCAA (Instituto Nacional de Cine y Artes Audiovisuales – Argentina).

Các giá trị hợp lệ cho thuộc tính này là:
  • 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 do Uỷ ban phân loại phim Kenya đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • kfcb16plus – 16
  • kfcbG – GE
  • kfcbPg – PG
  • kfcbR – 18 tuổi
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (Hà Lan).

Các giá trị hợp lệ cho thuộc tính này là:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
Mức phân loại của Uỷ ban phân loại nội dung truyền thông Hàn Quốc (영상물등급위원회) dành cho 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 do Lembaga Sensor Film (Cục Kiểm duyệt Phim) của Indonesia đưa ra.

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 do Hội đồng phân loại độ tuổi phim của Malta đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • 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 do Hội đồng Truyền thông dành cho trẻ em và thanh thiếu niên của Viện Phim Đan Mạch (Det Danske Filminstitut) đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • mccyp11 – 11
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
Hệ thống phân loại video của Việt Nam – MCST

Các giá trị hợp lệ cho thuộc tính này là:
  • mcst0 – 0
  • mcst16plus – 16+
  • 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 do Cơ quan Phát triển Truyền thông (MDA) của Singapore và cụ thể là Hội đồng Kiểm duyệt Phim (BFC) của cơ quan này đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
Mức phân loại của video theo Medietilsynet, Cơ quan Truyền thông Na Uy.

Các giá trị hợp lệ cho thuộc tính này là:
  • medietilsynet11 – 11
  • medietilsynet12 – 12
  • medietilsynet15 – 15
  • medietilsynet18 – 18 tuổi
  • medietilsynet6 – 6
  • medietilsynet7 – 7
  • medietilsynet9 – 9
  • medietilsynetA – A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
Mức phân loại của video do Kansallinen Audiovisuaalinen Instituutti (Viện Nghe nhìn Quốc gia) của Phần Lan đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18 tuổi
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
Mức phân loại của video do Bộ Di sản và Hoạt động Văn hoá và Du lịch (Ý) đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
Mức phân loại của Ministerio de Cultura (Bộ Văn hoá) dành cho video ở Colombia.

Các giá trị hợp lệ cho thuộc tính này là:
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18 tuổi
  • 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 do Bộ Văn hoá Đài Loan (文化部) đưa ra.

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) cho 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 đoạn giới thiệu và bản xem trước phim.

Các giá trị hợp lệ cho thuộc tính này là:
  • mpaatGb – GB (Green Band – Được phê duyệt cho mọi đối tượng)
  • mpaatRb – RB (Red Band – Khuyên dùng cho người từ 17 tuổi trở lên)
contentDetails.contentRating.mtrcbRating string
Mức phân loại của video do Hội đồng phân loại và đánh giá phim và truyền hình (Philippines) đưa ra.

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 video của 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 – 15+
  • nbc18plus – 18+
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Mức phân loại của video do Bulgarian National Film Center (Trung tâm Điện ảnh Quốc gia Bulgaria) đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
Mức phân loại của video do Hội đồng kiểm duyệt phim và video quốc gia của Nigeria cấp.

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 do Nacionãlais Kino centrs (Trung tâm Điện ảnh Quốc gia Latvia) đưa ra.

Các giá trị hợp lệ cho thuộc tính này là:
  • nkclv12plus – 12+
  • nkclv18plus – 18+
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Mức phân loại của video theo Văn phòng phân loại phim và văn học (OFLC – New Zealand).

Các giá trị hợp lệ cho thuộc tính này là:
  • oflcG – G
  • oflcM – Triệu
  • 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 tuổi
  • 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 video theo Tổng cục Phát thanh, Truyền hình và Điện ảnh (Mexico).

Các giá trị hợp lệ cho thuộc tính này là:
  • 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 (Đài phát thanh và truyền hình Ireland).

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 video theo Cơ quan đăng ký phim quốc gia của Liên bang Nga (MKRF – Nga).

Các giá trị hợp lệ cho thuộc tính này là:
  • russia0 – 0+
  • russia12 – 12+
  • russia16 – 16+
  • russia18 – 18+
  • russia6 – 6+
  • 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 tuổi
  • 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 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 lứa 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 dùng để xác định nội dung bị giới hạn độ tuổi.

Các giá trị hợp lệ cho thuộc tính này là:
  • 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ỏ tùy chỉnh cho video hay không. Chỉ người tải video lên mới thấy thuộc tính này.
status object
Đối tượng status chứa thông tin về trạng thái tải lên, xử lý và quyền riêng tư của video.
status.uploadStatus 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 không tải được video lên. Thuộc tính này chỉ xuất hiện nếu thuộc tính uploadStatus cho biết quá trình tải lên không thành công.

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 được tải lên. Thuộc tính này chỉ xuất hiện nếu thuộc tính uploadStatus cho biết rằng video 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. Trong yêu cầu videos.insert, nếu bạn không chỉ định giá trị cho thuộc tính này, thì trạng thái riêng tư của video được tải lên sẽ mặc định là public. Một số video tải lên có thể được đặt mặc định là private dựa trên chế độ cài đặt tài khoản của nhà sáng tạo, như giải thích trong Trung tâm trợ giúp của YouTube. Video được tải lên từ các dự án API chưa được xác minh không bị hạn chế ở chế độ xem riêng tư.

Các giá trị hợp lệ cho thuộc tính này là:
  • private
  • public
  • unlisted
status.publishAt datetime
Ngày và giờ mà video được lên lịch xuất bản. Bạn chỉ có thể đặt thuộc tính này nếu video có trạng thái quyền riêng tư là riêng tư. Giá trị được chỉ định ở định dạng ISO 8601. Xin lưu ý 2 điểm bổ sung sau đây về 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, bạn cũng phải đặt giá trị của thuộc tính status.privacyStatus thành private ngay cả khi video đã ở chế độ riêng tư.
  • Bạn chỉ có thể đặt thuộc tính này nếu trạng thái quyền riêng tư của video là private và video chưa từng được xuất bản.
  • 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 nào đó trong quá khứ, thì video sẽ được xuất bản ngay lập tức. Do đó, việc đặt thuộc tính status.publishAt thành một ngày và giờ trong quá khứ sẽ có hiệu lực tương tự như việc thay đổi privacyStatus của video từ private thành public.
status.license string
Giấy phép của video.

Các giá trị hợp lệ 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 trên một trang web khác hay không.
status.publicStatsViewable boolean
Giá trị này cho biết liệu số liệu thống kê mở rộng về video trên trang xem video có được công khai hay không. Theo mặc định, những số liệu thống kê đó có thể xem được và các số liệu thống kê như số lượt xem và điểm xếp hạng của video vẫn sẽ hiển thị công khai ngay cả khi giá trị của thuộc tính này được đặt thành false.
status.madeForKids boolean
Giá trị này cho biết liệu video có được chỉ định là hướng đến trẻ em hay không và chứa trạng thái "dành cho trẻ em" hiện tại của video. Ví dụ: trạng thái có thể được xác định dựa trên giá trị của thuộc tính selfDeclaredMadeForKids. Hãy xem Trung tâm trợ giúp của YouTube để biết thêm thông tin về cách đặt đối tượng người xem cho kênh, video hoặc chương trình phát sóng của bạn.
status.selfDeclaredMadeForKids 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à dành cho trẻ em. Trong yêu cầu videos.list, giá trị thuộc tính chỉ được trả về nếu chủ sở hữu kênh cho phép yêu cầu API.
status.containsSyntheticMedia 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 đã được chỉnh sửa hoặc nhân tạo (A/S) trông như thật. Tìm hiểu thêm về các chính sách của YouTube liên quan đến nội dung về hành vi tự huỷ hoại bản thân.

Ví dụ về nội dung dành cho người lớn bao gồm những video:
  • Tạo hình ảnh người thật có vẻ như nói hoặc làm điều gì đó mà người đó thực sự không nói hoặc làm
  • 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 24 tháng 8 năm 2026, đối với tất cả định dạng video (video dài, sự kiện phát trực tiếp và video Shorts) trên một kênh, viewCount sẽ được cập nhật để tính lượt xem ngay khi video bắt đầu phát (bao gồm cả tính năng tự động phát, di chuột qua và nhấp/nhấn để phát).
statistics.likeCount unsigned long
Số người dùng cho biết rằng họ thích video.
statistics.dislikeCount unsigned long
Lưu ý: Thuộc tính statistics.dislikeCount đã được đặt ở chế độ riêng tư kể từ ngày 13 tháng 12 năm 2021. Điều này có nghĩa là thuộc tính này chỉ được đưa vào phản hồi của API nếu yêu cầu API được chủ sở hữu video xác thực. Hãy xem nhật ký sửa đổi để biết thêm thông tin.

Số người dùng cho biết rằng họ không thích video.
statistics.favoriteCount unsigned long
Lưu ý: Thuộc tính này không được dùng nữa. Việc ngừng cung cấp có hiệu lực từ ngày 28 tháng 8 năm 2015. Giờ đây, giá trị của thuộc tính này luôn được đặt thành 0.
statistics.commentCount unsigned long
Số lượng bình luận về video.
paidProductPlacementDetails object
Đối tượng paidProductPlacementDetails chứa thông tin về nội dung được trả tiền để lồng ghép sản phẩm trong video.
paidProductPlacementDetails.hasPaidProductPlacement boolean
Đặt thành true nếu nội dung có nội dung được trả tiền để lồng ghép sản phẩm. Giá trị mặc định là false.
player object
Đối tượng player chứa thông tin mà bạn sẽ dùng để phát video trong trình phát được nhúng.
player.embedHtml string
Thẻ <iframe> nhúng một 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 về maxHeight và/hoặc maxWidth.
  • Nếu tỷ lệ khung hình của video không xác định, thì trình phát được nhúng sẽ mặc định là đị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 tham 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 trả về trong thuộc tính player.embedHtml. Thuộc tính này chỉ được trả về nếu yêu cầu chỉ định một giá trị cho tham số maxHeight và/hoặc maxWidth và tỷ lệ khung hình của video đã được xác định.
topicDetails object
Đối tượng topicDetails đóng gói thông tin về các chủ đề liên quan đến video.

Quan trọng: Hãy xem định nghĩa về các thuộc tính topicDetails.relevantTopicIds[] và topicDetails.topicIds[] cũng như nhật ký sửa đổi để biết thêm thông tin chi tiết về những thay đổi sắp tới liên quan đến mã chủ đề.
topicDetails.topicIds[] list
Lưu ý quan trọng: Thuộc tính này đã ngừng hoạt động kể từ ngày 10 tháng 11 năm 2016. API này không còn trả về giá trị cho thuộc tính này nữa và mọi chủ đề liên quan đến video hiện được trả về theo giá trị thuộc tính topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[] list
Danh sách mã chủ đề có liên quan đến video.

Thuộc tính này đã ngừng hoạt động kể từ ngày 10 tháng 11 năm 2016. API này sẽ được hỗ trợ cho đến ngày 10 tháng 11 năm 2017.

Lưu ý quan trọng: Do Freebase và Freebase API không còn được dùng nữa, nên mã nhận dạng chủ đề bắt đầu hoạt động theo cách khác kể từ ngày 27 tháng 2 năm 2017. Vào thời điểm đó, YouTube bắt đầu trả về một nhóm nhỏ mã chủ đề được tuyển chọn.
topicDetails.topicCategories[] list
Danh sách các URL trên Wikipedia cung cấp thông tin mô tả chung về nội dung của video.
recordingDetails object
Đối tượng recordingDetails đóng gói thông tin về vị trí, ngày và địa chỉ nơi video được ghi lại.
recordingDetails.locationDescription string
Thuộc tính này không được dùng nữa kể từ ngày 1 tháng 6 năm 2017. Vui lòng xem thông báo về việc ngừng sử dụng để biết thêm thông tin chi tiết.

Nội dung mô tả bằng văn bản về địa điểm quay video.
recordingDetails.location object
Thuộc tính này không được dùng nữa. Tất cả các thuộc tính con (vĩ độ, kinh độ, độ cao) đều không được dùng nữa.

Thông tin vị trí địa lý liên kết với video. Giá trị thuộc tính con xác định vị trí mà chủ sở hữu video muốn liên kết với video. Bạn có thể chỉnh sửa giá trị này, tìm kiếm trên video công khai và giá trị này có thể xuất hiện cho người dùng trên video công khai.
recordingDetails.location.latitude double
Thuộc tính này không được dùng nữa kể từ ngày 1 tháng 6 năm 2017. Vui lòng xem thông báo về việc ngừng sử dụng để 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 ngừng sử dụng để 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 dùng nữa kể từ ngày 9 tháng 7 năm 2018. Vui lòng xem thông báo về việc không dùng nữa để biết thêm thông tin chi tiết.

Độ cao so với ellipsoid 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 đóng gói thông tin về tệp video đã được tải lên YouTube, bao gồm độ phân giải, thời lượng, bộ mã hoá và giải mã âm thanh và video, tốc độ bit của luồng và nhiều thông tin khác. Chỉ chủ sở hữu video mới có thể truy xuất dữ liệu này.

Đối tượng fileDetails sẽ chỉ được trả về nếu thuộc tính processingDetails.fileAvailability có giá trị là available.
fileDetails.fileName string
Tên của tệp đã tải lên. Trường này xuất hiện cho dù tệp video hay một loại tệp khác được tải lên.
fileDetails.fileSize unsigned long
Kích thước của tệp được tải lên tính bằng byte. Trường này 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 đã tải lên theo 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 dù bạn tải tệp video hay một loại tệp khác lên.

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 này 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 này là một tệp hình ảnh, chẳng hạn như hình ảnh .jpeg.
  • other – Tệp này là một loại tệp khác không phải video.
  • project – Tệp 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à 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 được 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ã 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 được 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à sự kiện phát trực tiếp sử dụng.
fileDetails.videoStreams[].bitrateBps unsigned long
Tốc độ bit của luồng video, tính bằng bit/giây.
fileDetails.videoStreams[].rotation string
Mức độ mà YouTube cần xoay nội dung nguồn ban đầu để hiển thị video đúng cách.

Các giá trị hợp lệ cho thuộc tính này là:
  • 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 – Video không cần xoay.
  • other – Video cần được xoay theo một cách khác, không đơn giản.
  • upsideDown – Video cần được xoay ngược.
fileDetails.videoStreams[].vendor string
Giá trị nhận dạng duy nhất của 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 được 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à sự kiện phát trực tiếp sử dụng.
fileDetails.audioStreams[].bitrateBps unsigned long
Tốc độ bit của luồng âm thanh, tính bằng bit/giây.
fileDetails.audioStreams[].vendor string
Giá trị xác định duy nhất một nhà cung cấp video. Thông thường, giá trị 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/giây.
fileDetails.creationTime string
Ngày và giờ tạo tệp video đã tải lên. Giá trị được chỉ định ở định dạng ISO 8601. Hiện tại, chúng tôi hỗ trợ các định dạng ISO 8601 sau đây:
  • Chỉ ngày: YYYY-MM-DD
  • Thời gian chưa được bản địa hoá: 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 của YouTube trong việc xử lý tệp video đã tải lên. Các thuộc tính trong đối tượng này xác định trạng thái xử lý hiện tại và thời gian ước tính còn lại cho đến khi YouTube xử lý xong video. Phần này cũng cho biết liệu các loại dữ liệu hoặc nội dung khác nhau (chẳng hạn như thông tin chi tiết về tệp hoặc hình thu nhỏ) có được cung cấp cho video hay không.

Đối tượng processingProgress được thiết kế để được thăm dò ý kiến để video đã tải lên có thể theo dõi tiến trình xử lý tệp video đã tải lên của YouTube. Chỉ chủ sở hữu video mới có thể truy xuất dữ liệu này.
processingDetails.processingStatus string
Trạng thái xử lý của video. Giá trị này cho biết liệu YouTube có xử lý được video hay không hoặc video vẫn đang được xử lý.

Các giá trị hợp lệ cho thuộc tính này là:
  • 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 – Thông tin xử lý không còn nữa.
processingDetails.processingProgress object
Đối tượng processingProgress chứa thông tin về tiến trình xử lý video của YouTube. Các giá trị này chỉ thực sự phù hợp nếu trạng thái xử lý của video là processing.
processingDetails.processingProgress.partsTotal unsigned long
Số lượng ước tính về tổng số phần cần xử lý 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 quá trình YouTube xử lý video.
processingDetails.processingProgress.partsProcessed unsigned long
Số lượng 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:
100 * parts_processed / parts_total

Xin lưu ý rằng vì số lượng phần ước tính có thể tăng mà không có sự gia tăng tương ứng về số lượng phần đã được xử lý, nên có thể tiến trình được tính toán sẽ 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 đã gặp lỗi.
  • streamingFailed – Không gửi được video cho người phát trực tiếp.
  • transcodeFailed – Không chuyển mã được nội dung.
  • 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ó sẵn cho video đã tải lên hay không. Bạn có thể truy xuất thông tin chi tiết về tệp của 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 đã tạo ra các đề xuất có thể cải thiện khả năng xử lý video của YouTube, các cảnh báo giải thích vấn đề khi xử lý video hay các lỗi gây ra vấn đề khi xử lý video hay chưa. Bạn có thể truy xuất các đề xuất này bằng cách yêu cầu phần suggestions trong yêu cầu videos.list().
processingDetails.tagSuggestionsAvailability string
Giá trị này cho biết liệu video có gợi ý từ khoá (thẻ) hay không. Bạn có thể thêm thẻ vào siêu dữ liệu của video để giúp những 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 video có được đề xuất chỉnh sửa video hay không. Đề xuất này có thể cải thiện chất lượng video hoặc trải nghiệm phát. Bạn có thể truy xuất các đề xuất này bằng cách yêu cầu phần suggestions trong yêu cầu videos.list().
processingDetails.thumbnailsAvailability string
Giá trị này cho biết video đã được tạo hình thu nhỏ hay chưa.
suggestions object
Đối tượng suggestions bao bọc 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 được 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 đã 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á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 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 đưa ra trước khi YouTube thực sự xử lý tệp video đã tải lên. Ngoài ra, các giá trị này còn xác định những vấn đề không nhất thiết cho thấy quá trình xử lý video sẽ không thành công nhưng vẫn có thể gây ra sự cố, chẳng hạn như vấn đề về đồng bộ hoá, lỗi hình ảnh video hoặc thiếu bản âm thanh.

Các giá trị hợp lệ cho thuộc tính này là:
  • hasEditlist – Tính năng chỉnh sửa danh sách hiện chưa được hỗ trợ.
  • inconsistentResolution – Độ phân giải của vùng chứa và luồng không khớp nhau.
  • problematicAudioCodec – Bộ mã hoá và giải mã âm thanh đã biết là gây ra vấn đề đã được sử dụng.
  • problematicVideoCodec – Bộ mã hoá và giải mã video gây ra vấn đề đã được sử dụng.
  • unknownAudioCodec – Bộ mã hoá và giải mã âm thanh không được nhận dạng, quá trình chuyển mã có thể không thành công.
  • unknownContainer – Định dạng tệp không được nhận dạng, có thể quá trình chuyển mã sẽ không thành công.
  • unknownVideoCodec – Bộ mã hoá và giải mã video không nhận dạng được, quá trình chuyển mã có thể không thành công.
suggestions.processingHints[] list
Danh sách các đề xuất có thể cải thiện khả năng xử lý video của YouTube.

Các giá trị hợp lệ cho thuộc tính này là:
  • nonStreamableMov – Không thể phát trực tuyến tệp MP4, điều này sẽ làm chậm quá trình xử lý.
  • sendBestQualityVideo – Có thể có phiên bản chất lượng cao hơn của video.
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 nhóm danh mục video mà thẻ này có liên quan. Bạn có thể sử dụng thông tin này để hiển thị các đề xuất thẻ phù hợp dựa trên danh mục video mà người tải video lên liên kết với video. Theo mặc định, các đề xuất thẻ sẽ phù hợp với tất cả danh mục nếu không có quy định hạn chế nào đối với từ khoá.
suggestions.editorSuggestions[] 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 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ẻ không có tiếng và có thể được thay bằng một 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 phù hợp và có thể điều chỉnh được.
  • videoCrop – Có thể cắt lề (màu nền) phát hiện được xung quanh ả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 chương trình phát sóng video trực tiếp. Đối tượng này sẽ chỉ xuất hiện trong tài nguyên video nếu video là một sự kiện phát sóng trực tiếp sắp diễn ra, đang diễn ra hoặc đã hoàn tất.
liveStreamingDetails.actualStartTime 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. Giá trị này sẽ chỉ có sau khi chương trình 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. Giá trị này sẽ chỉ có sau khi buổi 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 thuộc tính không có, 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 đang xem chương trình phát sóng. Thuộc tính và giá trị của thuộc tính sẽ xuất hiện nếu chương trình phát sóng có người xem hiện tại và chủ sở hữu chương trình phát sóng không ẩn số lượt xem của video. Xin lưu ý rằng YouTube sẽ ngừng theo dõi số người xem đồng thời cho một sự kiện phát sóng khi sự kiện đó kết thúc. Do đó, thuộc tính này sẽ không xác định số lượng người xem một video lưu trữ của một chương trình phát sóng trực tiếp đã kết thúc.
Số người xem đồng thời mà YouTube Data API trả về có thể khác với số người xem đồng thời đã được xử lý và lọc bỏ nội dung rác có trong YouTube Analytics. Tìm hiểu thêm về các chỉ số của sự kiện phát trực tiếp trong Trung tâm trợ giúp của YouTube.
liveStreamingDetails.activeLiveChatId string
Mã nhận dạng của Trò chuyện trong sự kiện phát trực tiếp hiện đang hoạt động được đính kèm với video này. Trường này chỉ được điền nếu video là một chương trình phát sóng trực tiếp đang diễn ra và có tính năng Trò chuyện trong sự kiện phát trực tiếp. Sau khi chương trình phát sóng chuyển sang trạng thái hoàn tất, trường này sẽ bị xoá và Trò chuyện trong sự kiện phát trực tiếp sẽ kết thúc. Đối với các chương trình phát sóng cố định, mã Trò chuyện trong sự kiện phát trực tiếp đó sẽ không còn được liên kết với video này mà sẽ liên kết với video mới xuất hiện trên trang cố định.
brandPartner object
Đối tượng brandPartner chứa thông tin chi tiết về đối tác thương hiệu được liên kết với video cho Quyền truy cập cho đối tác thương hiệu do nhà sáng tạo cấp (CI BPA).
brandPartner.channelId string
Mã nhận dạng kênh bên ngoài của đối tác thương hiệu. Trường này phải bắt đầu bằng "UC". Bạn phải đặt channelId hoặc channelHandle khi thiết lập quyền truy cập, nhưng chỉ channelId được trả về trong phản hồi.
brandPartner.channelHandle string
Tên người dùng của đối tác thương hiệu. Trường này phải bắt đầu bằng "@". Bạn phải đặt channelId hoặc channelHandle khi thiết lập quyền truy cập, nhưng chỉ channelId được trả về trong phản hồi.
localizations object
Đối tượng localizations chứa bản dịch siêu dữ liệu của video.
localizations.(key) object
Ngôn ngữ của văn bản được 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 đã bản địa hoá.
localizations.(key).description string
Nội dung mô tả video đã bản địa hoá.