Trang này được dịch bởi Cloud Translation API.

API Reference

API Dữ liệu YouTube cho phép bạn kết hợp các chức năng thường được thực thi trên trang web YouTube vào trang web hoặc ứng dụng của riêng bạn. Danh sách dưới đây xác định những loại tài nguyên có thể truy xuất bằng API. API cũng hỗ trợ các phương thức chèn, cập nhật hoặc xoá nhiều tài nguyên trong số này.

Hướng dẫn tham khảo này giải thích cách sử dụng API để thực hiện tất cả các thao tác này. Hướng dẫn này được sắp xếp theo loại tài nguyên. Tài nguyên đại diện cho một loại mục bao gồm một phần của trải nghiệm YouTube, chẳng hạn như video, danh sách phát hoặc gói thuê bao. Đối với mỗi loại tài nguyên, hướng dẫn này liệt kê một hoặc nhiều bản trình bày dữ liệu và tài nguyên được biểu thị dưới dạng đối tượng JSON. Hướng dẫn này cũng liệt kê một hoặc nhiều phương thức được hỗ trợ (LIST, POST, DELETE, v.v.) cho từng loại tài nguyên và giải thích cách sử dụng các phương thức đó trong ứng dụng của bạn.

Gọi API

Những yêu cầu sau áp dụng cho các yêu cầu về API Dữ liệu YouTube:

Mỗi yêu cầu phải chỉ định một khóa API (với thông số key) hoặc cung cấp mã thông báo OAuth 2.0. Khoá API có trong ngăn Quyền truy cập API của Developer Console cho dự án của bạn.
Bạn phải gửi mã thông báo uỷ quyền cho mọi yêu cầu chèn, cập nhật và xoá. Bạn cũng phải gửi mã thông báo uỷ quyền cho mọi yêu cầu truy xuất dữ liệu riêng tư của người dùng đã xác thực.

Ngoài ra, một số phương thức API để truy xuất tài nguyên có thể hỗ trợ các tham số yêu cầu ủy quyền hoặc có thể chứa siêu dữ liệu bổ sung khi các yêu cầu được ủy quyền. Ví dụ: yêu cầu truy xuất các video đã tải lên của người dùng cũng có thể chứa các video riêng tư nếu yêu cầu đó được một người dùng cụ thể cho phép.
API này hỗ trợ giao thức xác thực OAuth 2.0. Bạn có thể cung cấp mã thông báo OAuth 2.0 theo một trong các cách sau:
- Sử dụng tham số truy vấn access_token như sau: ?access_token=oauth2-token
- Dùng tiêu đề HTTP Authorization như sau: Authorization: Bearer oauth2-token
Bạn có thể xem hướng dẫn đầy đủ về cách triển khai xác thực OAuth 2.0 trong ứng dụng của mình trong hướng dẫn xác thực.

Loại tài nguyên

Hoạt động

Tài nguyên activity chứa thông tin về một hành động mà một kênh hoặc người dùng cụ thể đã thực hiện trên YouTube. Các hành động được báo cáo trong nguồn cấp dữ liệu hoạt động bao gồm xếp hạng video, chia sẻ video, đánh dấu video là video yêu thích, tải video lên, v.v. Mỗi tài nguyên activity xác định loại hành động, kênh liên kết với hành động và tài nguyên liên kết với hành động, chẳng hạn như video đã được xếp hạng hoặc tải lên.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`list`	`GET /activities`	Trả về danh sách các sự kiện hoạt động của kênh phù hợp với tiêu chí của yêu cầu. Ví dụ: bạn có thể truy xuất các sự kiện được liên kết với một kênh cụ thể hoặc với kênh của chính người dùng đó.
`insert`	`POST /activities`	Lưu ý: Phương thức này đã ngừng hoạt động và không còn được hỗ trợ nữa.

Phụ đề

Tài nguyên caption đại diện cho phụ đề trên YouTube. Một bản phụ đề được liên kết với đúng một video trên YouTube.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`delete`	`DELETE /captions`	Xóa phụ đề được chỉ định.
`download`	`GET /captions/id`	Tải bản phụ đề xuống. Phụ đề được trả về ở định dạng gốc trừ khi yêu cầu chỉ định một giá trị cho tham số `tfmt` và ở ngôn ngữ gốc, trừ khi yêu cầu chỉ định một giá trị cho tham số `tlang`.
`insert`	`POST /captions`	Tải phụ đề lên.
`list`	`GET /captions`	Trả về danh sách phụ đề được liên kết với một video cụ thể. Lưu ý rằng phản hồi API không chứa phụ đề thực tế và phương thức `captions.download` cung cấp khả năng truy xuất phụ đề gốc.
`update`	`PUT /captions`	Cập nhật phụ đề gốc. Khi cập nhật phụ đề gốc, bạn có thể thay đổi trạng thái bản nháp của bản phụ đề, tải tệp phụ đề mới lên cho bản nhạc đó hoặc cả hai.

Biểu ngữ kênh

Tài nguyên channelBanner chứa URL mà bạn sẽ dùng để đặt hình ảnh mới tải lên làm ảnh biểu ngữ cho một kênh.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức Yêu cầu HTTP Mô tả

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`insert`	`POST /channelBanners/insert`	Tải ảnh biểu ngữ kênh lên YouTube. Phương pháp này thể hiện hai bước đầu tiên trong quy trình ba bước để cập nhật ảnh biểu ngữ cho một kênh: Gọi phương thức `channelBanners.insert` để tải dữ liệu hình ảnh nhị phân lên YouTube. Hình ảnh phải có tỷ lệ khung hình 16:9 và kích thước tối thiểu là 2048x1152 pixel. Bạn nên tải hình ảnh có kích thước 2560 px x 1440 px lên. Trích xuất giá trị của thuộc tính `url` từ phản hồi mà API trả về cho bước 1. Hãy gọi phương thức `channels.update` để cập nhật chế độ cài đặt thương hiệu của kênh. Đặt giá trị của thuộc tính `brandingSettings.image.bannerExternalUrl` thành URL thu được ở bước 2.

URI tương ứng với https://www.googleapis.com/youtube/v3

insert

POST /channelBanners/insert

Tải ảnh biểu ngữ kênh lên YouTube. Phương pháp này thể hiện hai bước đầu tiên trong quy trình ba bước để cập nhật ảnh biểu ngữ cho một kênh:

Gọi phương thức channelBanners.insert để tải dữ liệu hình ảnh nhị phân lên YouTube. Hình ảnh phải có tỷ lệ khung hình 16:9 và kích thước tối thiểu là 2048x1152 pixel. Bạn nên tải hình ảnh có kích thước 2560 px x 1440 px lên.
Trích xuất giá trị của thuộc tính url từ phản hồi mà API trả về cho bước 1.
Hãy gọi phương thức channels.update để cập nhật chế độ cài đặt thương hiệu của kênh. Đặt giá trị của thuộc tính brandingSettings.image.bannerExternalUrl thành URL thu được ở bước 2.

Các phần kênh

Tài nguyên channelSection chứa thông tin về một tập hợp video mà kênh đã chọn để giới thiệu. Ví dụ: Một phần có thể có nội dung tải lên mới nhất của kênh, video tải lên phổ biến nhất hoặc video từ một hoặc nhiều danh sách phát.

Lưu ý rằng phần của kênh chỉ hiển thị nếu kênh hiển thị nội dung trong chế độ xem duyệt qua (thay vì chế độ xem nguồn cấp dữ liệu). Để cho phép một kênh hiển thị nội dung trong chế độ xem duyệt qua, hãy đặt thuộc tính brandingSettings.channel.showBrowseView thành true cho kênh được chỉ định.

Một kênh có thể tạo tối đa 10 kệ.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`delete`	`DELETE /channelSections`	Xoá một phần kênh.
`insert`	`POST /channelSections`	Thêm một phần kênh vào kênh của người dùng đã xác thực. Một kênh có thể tạo tối đa 10 kệ.
`list`	`GET /channelSections`	Trả về danh sách tài nguyên `channelSection` khớp với tiêu chí của yêu cầu API.
`update`	`PUT /channelSections`	Cập nhật phần kênh.

Kênh

Tài nguyên channel chứa thông tin về một kênh YouTube.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`list`	`GET /channels`	Trả về một tập hợp từ 0 tài nguyên `channel` trở lên phù hợp với tiêu chí của yêu cầu.
`update`	`PUT /channels`	Cập nhật siêu dữ liệu của kênh. Xin lưu ý rằng phương thức này hiện chỉ hỗ trợ việc cập nhật các đối tượng `brandingSettings` và `invideoPromotion` của tài nguyên `channel` và các thuộc tính con của các đối tượng đó.

Bình luận

Tài nguyên commentThread chứa thông tin về chuỗi nhận xét trên YouTube, trong đó có một nhận xét cấp cao nhất và các phản hồi (nếu có) cho nhận xét đó. Tài nguyên commentThread có thể biểu thị nhận xét về một video hoặc một kênh.

Cả nhận xét cấp cao nhất và phản hồi thực ra đều là tài nguyên comment lồng trong tài nguyên commentThread. Tài nguyên commentThread không nhất thiết phải chứa tất cả các câu trả lời cho một nhận xét và bạn cần phải sử dụng phương thức comments.list nếu muốn truy xuất tất cả các câu trả lời cho một nhận xét cụ thể. Ngoài ra, xin lưu ý rằng một số bình luận không có phản hồi.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`list`	`GET /commentThreads`	Trả về danh sách các chuỗi nhận xét khớp với thông số của yêu cầu API.
`insert`	`POST /commentThreads`	Tạo nhận xét mới cấp cao nhất. Để thêm câu trả lời vào nhận xét hiện có, hãy sử dụng phương thức `comments.insert`.

Bình luận

Tài nguyên comment chứa thông tin về một bình luận trên YouTube. Tài nguyên comment có thể biểu thị nhận xét về một video hoặc một kênh. Ngoài ra, nhận xét đó có thể là nhận xét cấp cao nhất hoặc trả lời nhận xét cấp cao nhất.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`list`	`GET /comments`	Trả về danh sách các nhận xét khớp với thông số yêu cầu API.
`setModerationStatus`	`POST /comments/setModerationStatus`	Đặt trạng thái kiểm duyệt của một hoặc nhiều nhận xét. Yêu cầu API phải được chủ sở hữu của kênh hoặc video liên kết với nhận xét cho phép.
`insert`	`POST /comments`	Tạo câu trả lời cho nhận xét hiện có. Lưu ý: Để tạo một nhận xét cấp cao nhất, hãy sử dụng phương thức `commentThreads.insert`.
`markAsSpam`	`POST /comments/markAsSpam`	Thể hiện quan điểm của người gọi rằng một hoặc nhiều nhận xét sẽ bị gắn cờ là spam.
`delete`	`DELETE /comments`	Xoá một nhận xét.
`update`	`PUT /comments`	Sửa đổi một nhận xét.

Danh mục hướng dẫn

Tài nguyên guideCategory xác định danh mục mà YouTube chỉ định bằng thuật toán dựa trên nội dung của kênh hoặc các chỉ báo khác, chẳng hạn như mức độ phổ biến của kênh. Danh sách này tương tự như danh mục video, điểm khác biệt là người tải video lên có thể chỉ định danh mục video nhưng chỉ YouTube mới có thể chỉ định danh mục kênh.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`list`	`GET /guideCategories`	Trả về danh sách các danh mục có thể liên kết với kênh YouTube.

Ngôn ngữ I18

Tài nguyên i18nLanguage xác định ngôn ngữ ứng dụng mà trang web YouTube hỗ trợ. Ngôn ngữ của ứng dụng cũng có thể được gọi là ngôn ngữ giao diện người dùng. Đối với trang web YouTube, ngôn ngữ của ứng dụng có thể được chọn tự động dựa trên cài đặt Tài khoản Google, ngôn ngữ trình duyệt hoặc vị trí IP. Người dùng cũng có thể chọn ngôn ngữ giao diện người dùng mong muốn theo cách thủ công ở chân trang web YouTube.

Mỗi tài nguyên i18nLanguage sẽ xác định một mã ngôn ngữ và tên. Bạn có thể sử dụng mã ngôn ngữ làm giá trị của thông số hl khi gọi các phương thức API như videoCategories.list và guideCategories.list.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`list`	`GET /i18nLanguages`	Trả về danh sách những ngôn ngữ mà ứng dụng YouTube hỗ trợ.

Vùng I18

Tài nguyên i18nRegion xác định một khu vực địa lý mà người dùng YouTube có thể chọn làm khu vực nội dung ưu tiên. Khu vực nội dung còn có thể được gọi là ngôn ngữ nội dung. Đối với trang web YouTube, hệ thống có thể tự động chọn một khu vực nội dung dựa trên các thông tin phỏng đoán như miền YouTube hoặc vị trí IP của người dùng. Người dùng cũng có thể tự chọn khu vực nội dung mong muốn từ chân trang web của YouTube.

Mỗi tài nguyên i18nRegion sẽ xác định một mã vùng và tên. Bạn có thể sử dụng mã khu vực làm giá trị của thông số regionCode khi gọi các phương thức API như search.list, videos.list, activities.list và videoCategories.list.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`list`	`GET /i18nRegions`	Trả về danh sách vùng nội dung mà trang web YouTube hỗ trợ.

Hội viên

Tài nguyên member đại diện cho hội viên của một kênh YouTube. Một thành viên hỗ trợ định kỳ cho nhà sáng tạo và nhận các lợi ích đặc biệt. Ví dụ: Hội viên có thể trò chuyện khi nhà sáng tạo bật chế độ chỉ dành cho hội viên để trò chuyện.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`list`	`GET /members`	Liệt kê các thành viên (trước đây gọi là "nhà tài trợ") cho một kênh. Yêu cầu API phải được chủ sở hữu kênh cho phép.

Cấp độ hội viên

Tài nguyên membershipsLevel xác định mức giá cho người sáng tạo đã ủy quyền yêu cầu API.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`list`	`GET /membershipsLevels`	Trả về một tập hợp từ 0 tài nguyên `membershipsLevel` trở lên thuộc sở hữu của kênh đã uỷ quyền cho yêu cầu API. Các cấp độ được trả về theo thứ tự hiển thị ngầm ẩn.

Danh sách phát mục

Tài nguyên playlistItem xác định một tài nguyên khác, chẳng hạn như video, có trong danh sách phát. Ngoài ra, tài nguyên playlistItem chứa thông tin chi tiết về tài nguyên đi kèm cụ thể về cách sử dụng tài nguyên đó trong danh sách phát đó.

YouTube cũng sử dụng danh sách phát để xác định danh sách các video đã tải lên của một kênh, trong đó mỗi playlistItem trong danh sách đó đại diện cho một video đã tải lên. Bạn có thể truy xuất mã nhận dạng danh sách phát cho danh sách đó từ channel resource cho một kênh nhất định. Sau đó, bạn có thể sử dụng phương thức playlistItems.list cho danh sách này.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`delete`	`DELETE /playlistItems`	Xóa một mục trong danh sách phát.
`insert`	`POST /playlistItems`	Thêm tài nguyên vào danh sách phát.
`list`	`GET /playlistItems`	Trả về bộ sưu tập các mục trong danh sách phát khớp với thông số yêu cầu API. Bạn có thể truy xuất tất cả các mục trong danh sách phát trong một danh sách phát được chỉ định hoặc truy xuất một hoặc nhiều mục danh sách phát theo ID duy nhất.
`update`	`PUT /playlistItems`	Sửa đổi một mục trong danh sách phát. Ví dụ: bạn có thể cập nhật vị trí của mục trong danh sách phát.

Danh sách phát

Tài nguyên playlist đại diện cho danh sách phát trên YouTube. Danh sách phát là tập hợp video mà bạn có thể xem tuần tự và chia sẻ với người dùng khác. Danh sách phát có thể chứa tối đa 200 video và YouTube không giới hạn số lượng danh sách phát mà mỗi người dùng tạo ra. Theo mặc định, người dùng khác có thể xem danh sách phát nhưng công khai hoặc riêng tư danh sách phát.

YouTube cũng sử dụng danh sách phát để xác định các bộ sưu tập video đặc biệt cho một kênh, chẳng hạn như:

video đã tải lên
video được đánh giá tích cực (thích)
lịch sử xem
xem sau

Cụ thể hơn, những danh sách này được liên kết với một kênh YouTube. Đây là một tập hợp video, danh sách phát hoặc các thông tin khác của một người, nhóm hoặc công ty. Bạn có thể truy xuất mã nhận dạng danh sách phát cho từng danh sách trong số này từ channel resource cho một kênh nhất định.

Sau đó, bạn có thể dùng phương thức playlistItems.list để truy xuất bất kỳ danh sách nào trong số đó. Bạn cũng có thể thêm hoặc xoá các mục khỏi những danh sách đó bằng cách gọi phương thức playlistItems.insert và playlistItems.delete.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`delete`	`DELETE /playlists`	Xóa danh sách phát.
`list`	`GET /playlists`	Trả về một tập hợp các danh sách phát khớp với tham số yêu cầu API. Ví dụ: bạn có thể truy xuất tất cả danh sách phát mà người dùng đã xác thực sở hữu hoặc bạn có thể truy xuất một hoặc nhiều danh sách phát theo mã nhận dạng duy nhất của họ.
`insert`	`POST /playlists`	Tạo danh sách phát.
`update`	`PUT /playlists`	Sửa đổi một danh sách phát. Ví dụ: Bạn có thể thay đổi tiêu đề, nội dung mô tả hoặc trạng thái quyền riêng tư của một danh sách phát.

Tìm kiếm

Kết quả tìm kiếm chứa thông tin về một video, kênh hoặc danh sách phát trên YouTube khớp với các thông số tìm kiếm được chỉ định trong yêu cầu API. Mặc dù kết quả tìm kiếm trỏ đến một tài nguyên có thể nhận dạng riêng biệt, chẳng hạn như video, nhưng lại không có dữ liệu cố định.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`list`	`GET /search`	Trả về một tập hợp kết quả tìm kiếm phù hợp với các tham số truy vấn được chỉ định trong yêu cầu API. Theo mặc định, một nhóm kết quả tìm kiếm sẽ xác định các tài nguyên `video`, `channel` và `playlist` phù hợp, nhưng bạn cũng có thể định cấu hình các truy vấn để chỉ truy xuất một loại tài nguyên cụ thể.

Gói thuê bao

Tài nguyên subscription chứa thông tin về gói thuê bao của người dùng YouTube. Lượt đăng ký thông báo cho người dùng khi video mới được thêm vào kênh hoặc khi người dùng khác thực hiện một trong các hành động trên YouTube, chẳng hạn như tải video lên, xếp hạng video hoặc bình luận về video.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`delete`	`DELETE /subscriptions`	Xoá gói thuê bao.
`insert`	`POST /subscriptions`	Thêm gói thuê bao cho kênh của người dùng đã xác thực.
`list`	`GET /subscriptions`	Trả về tài nguyên gói thuê bao khớp với tiêu chí của yêu cầu API.

Hình thu nhỏ

Tài nguyên thumbnail xác định kích thước hình thu nhỏ khác nhau liên kết với một tài nguyên. Xin lưu ý các đặc điểm sau của hình thu nhỏ:

Thuộc tính snippet.thumbnails của tài nguyên là một đối tượng xác định các hình thu nhỏ hiện có cho tài nguyên đó.
Tài nguyên thumbnail chứa một loạt đối tượng. Tên của từng đối tượng (default, medium, high, v.v.) đề cập đến kích thước hình thu nhỏ.
Các loại tài nguyên khác nhau có thể hỗ trợ nhiều kích thước hình thu nhỏ.
Các loại tài nguyên khác nhau có thể xác định các kích thước khác nhau cho hình ảnh hình thu nhỏ có cùng tên. Ví dụ: hình thu nhỏ default cho tài nguyên video thường có kích thước 120px x 90px và hình thu nhỏ default cho tài nguyên channel thường là 88px x 88px.
Các tài nguyên thuộc cùng loại có thể vẫn có các kích thước hình thu nhỏ khác nhau cho một số hình ảnh nhất định tùy thuộc vào độ phân giải của hình ảnh gốc hoặc nội dung được tải lên YouTube. Ví dụ: video HD có thể hỗ trợ hình thu nhỏ có độ phân giải cao hơn so với video không phải HD.
Mỗi đối tượng chứa thông tin về kích thước hình thu nhỏ có một thuộc tính width và một thuộc tính height. Tuy nhiên, các thuộc tính chiều rộng và chiều cao có thể không được trả về cho hình ảnh đó.
Nếu hình thu nhỏ đã tải lên không khớp với kích thước bắt buộc, hình ảnh sẽ được đổi kích thước cho phù hợp với kích thước chính xác mà không thay đổi tỷ lệ khung hình. Hình ảnh không bị cắt nhưng có thể bao gồm các thanh màu đen để kích thước chính xác.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`set`	`POST /thumbnails/set`	Tải hình thu nhỏ tuỳ chỉnh của video lên YouTube và đặt hình thu nhỏ đó cho một video.

Những lý do vi phạm về báo cáo video

Tài nguyên videoAbuseReportReason chứa thông tin về lý do video bị gắn cờ do chứa nội dung lạm dụng. Khi ứng dụng của bạn gọi phương thức videos.reportAbuse để báo cáo video lạm dụng, yêu cầu sẽ sử dụng thông tin từ tài nguyên videoAbuseReportReason để xác định lý do video bị báo cáo.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`list`	`GET /videoAbuseReportReasons`	Truy xuất danh sách các lý do có thể dùng để báo cáo video lạm dụng.

Danh mục video

Tài nguyên videoCategory xác định một danh mục đã hoặc có thể được liên kết với video đã tải lên.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`list`	`GET /videoCategories`	Trả về danh sách danh mục có thể liên kết với video trên YouTube.

Video

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

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`insert`	`POST /videos`	Tải video lên YouTube và tuỳ chọn thiết lập siêu dữ liệu cho video.
`list`	`GET /videos`	Trả về danh sách video khớp với các tham số yêu cầu API.
`delete`	`DELETE /videos`	Xoá video trên YouTube.
`update`	`PUT /videos`	Cập nhật siêu dữ liệu của video.
`rate`	`POST /videos/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 video.
`getRating`	`GET /videos/getRating`	Truy xuất xếp hạng mà người dùng được ủy quyền đã cung cấp cho danh sách các video được chỉ định.
`reportAbuse`	`POST /videos/reportAbuse`	Báo cáo video chứa nội dung vi phạm.

Vân nước

Tài nguyên watermark xác định hình ảnh hiển thị trong khi phát video của một kênh cụ thể. Bạn cũng có thể chỉ định một kênh mục tiêu mà hình ảnh sẽ liên kết đến cũng như chi tiết thời gian xác định thời điểm hình mờ xuất hiện trong thời gian phát video và khoảng thời gian hình mờ xuất hiện.

Để biết thêm thông tin về tài nguyên này, hãy xem phần đại diện tài nguyên và danh sách các thuộc tính của tài nguyên đó.

Phương thức	Yêu cầu HTTP	Mô tả
URI tương ứng với `https://www.googleapis.com/youtube/v3`
`set`	`POST /watermarks/set`	Tải hình mờ lên YouTube và đặt hình ảnh đó cho kênh.
`unset`	`POST /watermarks/unset`	Xoá hình mờ của kênh.