API Dữ liệu YouTube cho phép bạn tích 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. Các danh sách bên dưới xác định các loại tài nguyên mà bạn có thể truy xuất bằng API. API này 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 là một loại mục trong 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 cách trình bày dữ liệu và tài nguyên được trình bày 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 mỗi 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.
Gọi API
Các yêu cầu sau đây áp dụng cho các yêu cầu gửi đến API Dữ liệu của YouTube:
-
Mỗi yêu cầu phải chỉ định một khoá API (bằng tham số
key
) hoặc cung cấp mã thông báo OAuth 2.0. Khoá API của bạn 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ã 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 thông số yêu cầu uỷ quyền hoặc có thể chứa siêu dữ liệu bổ sung khi các yêu cầu được uỷ quyền. Ví dụ: yêu cầu truy xuất video do người dùng tải lên cũng có thể chứa video riêng tư nếu yêu cầu đó được 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 hai cách sau:
- Sử dụng tham số truy vấn
access_token
như sau:?access_token=
oauth2-token
- Sử 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 quy trình xác thực OAuth 2.0 trong ứng dụng của mình trong hướng dẫn xác thực.
- Sử dụng tham số truy vấn
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 bản tin hoạt động bao gồm việc 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 được liên kết với hành động đó và(các) tài nguyên được 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ương thức trình bày tài nguyên và danh sách thuộc tính.
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 trên kênh khớp với tiêu chí yêu cầu. Ví dụ: bạn có thể truy xuất các sự kiện 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 không còn được dùng nữa và không còn được hỗ trợ. |
Phụ đề
Tài nguyên caption
đại diện cho một bản 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ương thức trình bày tài nguyên và danh sách thuộc tính.
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 |
Xoá bản phụ đề đã chỉ định. |
download |
GET /captions/id |
Tải bản phụ đề xuống. Phiên bản phụ đề được trả về ở định dạng gốc, trừ phi yêu cầu chỉ định giá trị cho tham số tfmt và ở ngôn ngữ gốc, trừ phi yêu cầu chỉ định giá trị cho tham số tlang . |
insert |
POST /captions |
Tải bản phụ đề lên. |
list |
GET /captions |
Trả về danh sách các bản phụ đề được liên kết với một video cụ thể. Xin 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 một kênh phụ đề. |
update |
PUT /captions |
Cập nhật bản phụ đề. Khi cập nhật một bản phụ đề, 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 phụ đề đó hoặc làm cả hai việc. |
ChannelBanners
Tài nguyên channelBanner
chứa URL mà bạn sẽ sử dụng để đặt hình ảnh mới tải lên làm hình ả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ương thức trình bày tài nguyên và danh sách thuộc tính.
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 thức này đại diện cho hai bước đầu tiên trong quy trình gồm 3 bước để cập nhật hình ảnh biểu ngữ cho một kênh:
|
ChannelSections
Tài nguyên channelSection
chứa thông tin về một nhóm video mà một kênh đã chọn để giới thiệu. Ví dụ: một phần có thể giới thiệu các video tải lên gần đây nhất, video tải lên phổ biến nhất hoặc video trong một hoặc nhiều danh sách phát của kênh.
Xin lưu ý rằng các phần của kênh chỉ xuất hiện nếu kênh hiển thị nội dung ở chế độ xem duyệt xem (thay vì chế độ xem trang Shorts). Để 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 đã 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ương thức trình bày tài nguyên và danh sách thuộc tính.
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í yêu cầu API. |
update |
PUT /channelSections |
Cập nhật mộ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ương thức trình bày tài nguyên và danh sách thuộc tính.
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 gồm 0 hoặc nhiều tài nguyên channel khớp với tiêu chí 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ợ nội dung cập nhật cho các đối tượng brandingSettings và invideoPromotion của tài nguyên channel cũng như các thuộc tính con của các đối tượng đó. |
CommentThreads
Tài nguyên commentThread
chứa thông tin về một chuỗi bình luận trên YouTube, bao gồm một bình luận cấp cao nhất và các câu trả lời (nếu có) cho bình luận đó. Tài nguyên commentThread
có thể đại diện cho các bình luận về một video hoặc một kênh.
Cả bình luận cấp cao nhất và các câu trả lời đều thực sự 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 bình luận và bạn cần 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 bình luận cụ thể. Ngoài ra, xin lưu ý rằng một số bình luận không có câu trả lời.
Để biết thêm thông tin về tài nguyên này, hãy xem phương thức trình bày tài nguyên và danh sách thuộc tính.
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 chuỗi bình luận khớp với các tham số yêu cầu API. |
insert |
POST /commentThreads |
Tạo một nhận xét cấp cao nhất mới. Để thêm một câu trả lời cho một bình luận hiện có, hãy sử dụng phương thức comments.insert . |
Bì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ể đại diện cho một bình luận về video hoặc kênh. Ngoài ra, bình luận có thể là bình luận cấp cao nhất hoặc bình luận trả lời bình luận cấp cao nhất.
Để biết thêm thông tin về tài nguyên này, hãy xem phương thức trình bày tài nguyên và danh sách thuộc tính.
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 các tham số yêu cầu API. |
setModerationStatus |
POST /comments/setModerationStatus |
Đặt trạng thái kiểm duyệt cho một hoặc nhiều bình luận. 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 các bình luận đó cho phép. |
insert |
POST /comments |
Tạo một bình luận trả lời một bình luận 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 |
Lưu ý: Phương thức này không còn được dùng nữa và không còn được hỗ trợ. |
delete |
DELETE /comments |
Xoá bình luận. |
update |
PUT /comments |
Sửa đổi một bình luận. |
GuideCategories
Tài nguyên guideCategory
xác định một danh mục mà YouTube chỉ định theo 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, chỉ khác ở chỗ người tải video lên có thể chỉ định danh mục video, còn danh mục kênh thì chỉ YouTube mới có thể chỉ định.
Để biết thêm thông tin về tài nguyên này, hãy xem phương thức trình bày tài nguyên và danh sách thuộc tính.
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. |
I18nLanguages
Tài nguyên i18nLanguage
xác định ngôn ngữ ứng dụng mà trang web YouTube hỗ trợ. Ngôn ngữ ứ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ữ ứng dụng có thể được tự động chọn dựa trên chế độ 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ể tự chọn ngôn ngữ giao diện người dùng mong muốn trong chân trang của trang web YouTube.
Mỗi tài nguyên i18nLanguage
xác định một mã ngôn ngữ và tên. Bạn có thể dùng mã ngôn ngữ làm giá trị của tham 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ương thức trình bày tài nguyên và danh sách thuộc tính.
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 ngôn ngữ ứng dụng mà trang web YouTube hỗ trợ. |
I18nRegions
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ũng có thể được gọi là ngôn ngữ nội dung. Đối với trang web YouTube, một khu vực nội dung có thể được tự động chọn dựa trên các phương pháp phỏng đoán như miền YouTube hoặc vị trí địa chỉ IP của người dùng. Người dùng cũng có thể chọn khu vực nội dung mong muốn theo cách thủ công trong chân trang của trang web YouTube.
Mỗi tài nguyên i18nRegion
xác định một mã khu vực và tên. Bạn có thể dùng mã khu vực làm giá trị của tham 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ương thức trình bày tài nguyên và danh sách thuộc tính.
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 các khu vực nội dung mà trang web YouTube hỗ trợ. |
Hội viên
Tài nguyên member
đại diện cho một hội viên của một kênh YouTube. Hội viên hỗ trợ tài chính định kỳ cho một 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 cho một cuộc trò chuyện.
Để biết thêm thông tin về tài nguyên này, hãy xem phương thức biểu thị tài nguyên và danh sách thuộc tính.
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 hội viên (trước đây gọi là "nhà tài trợ") của một kênh. Yêu cầu API phải được chủ sở hữu kênh uỷ quyền. |
MembershipsLevels
Tài nguyên membershipsLevel
xác định cấp giá cho nhà sáng tạo đã uỷ 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ương thức biểu thị tài nguyên và danh sách thuộc tính.
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 gồm 0 hoặc nhiều tài nguyên membershipsLevel do kênh đã uỷ quyền yêu cầu API sở hữu. Các cấp được trả về theo thứ tự hiển thị ngầm ẩn. |
PlaylistItems
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 liên quan cụ thể đến cách tài nguyên đó được sử dụng trong danh sách phát đó.
YouTube cũng sử dụng danh sách phát để xác định danh sách 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.
Để biết thêm thông tin về tài nguyên này, hãy xem phương thức trình bày tài nguyên và danh sách thuộc tính.
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 |
Xoá 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ề một tập hợp các mục trong danh sách phát khớp với các tham 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 đã chỉ định hoặc truy xuất một hoặc nhiều mục trong danh sách phát theo mã nhận dạng duy nhất của các mục đó. |
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 một danh sách phát trên YouTube. Danh sách phát là tập hợp các video mà bạn có thể xem theo thứ tự và chia sẻ với người dùng khác. Theo mặc định, danh sách phát sẽ hiển thị công khai cho người dùng khác. Tuy nhiên, bạn có thể đặt danh sách phát ở chế độ công khai hoặc riêng 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
channel resource
cho một kênh nhất định.Sau đó, bạn có thể sử 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 các 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ương thức trình bày tài nguyên và danh sách thuộc tính.
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 |
Xoá danh sách phát. |
list |
GET /playlists |
Trả về một tập hợp danh sách phát khớp với các 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 các danh sách phát đó. |
insert |
POST /playlists |
Tạo danh sách phát. |
update |
PUT /playlists |
Sửa đổi 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 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 một yêu cầu API. Mặc dù một 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ư một video), nhưng kết quả tìm kiếm đó không có dữ liệu ổn định riêng.
Để biết thêm thông tin về tài nguyên này, hãy xem phương thức trình bày tài nguyên và danh sách thuộc tính.
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 khớp với các tham số truy vấn được chỉ định trong yêu cầu API. Theo mặc định, tập hợp kết quả tìm kiếm sẽ xác định các tài nguyên video , channel và playlist trùng khớp, nhưng bạn cũng có thể định cấu hình truy vấn để chỉ truy xuất một loại tài nguyên cụ thể. |
Kênh đăng ký
Tài nguyên subscription
chứa thông tin về gói thuê bao của người dùng YouTube. Khi người dùng đăng ký kênh, họ sẽ nhận được thông báo khi kênh đó thêm video mới hoặc khi người dùng khác thực hiện một trong những thao tác 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ương thức trình bày tài nguyên và danh sách thuộc tính.
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á một 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ề các tài nguyên thuê bao khớp với tiêu chí yêu cầu API. |
Hình thu nhỏ
Tài nguyên thumbnail
xác định các kích thước hình thu nhỏ khác nhau được liên kết với một tài nguyên. Xin lưu ý các đặc điểm sau đây 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 hình thu nhỏ có sẵn cho tài nguyên đó. - Tài nguyên
thumbnail
chứa một loạt đối tượng. Tên của mỗi đố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ợ các kích thước hình thu nhỏ khác nhau.
- Các loại tài nguyên khác nhau có thể xác định kích thước khác nhau cho hình thu nhỏ có cùng tên. Ví dụ: hình thu nhỏ
default
cho tài nguyênvideo
thường có kích thước 120px x 90px và hình thu nhỏdefault
cho tài nguyênchannel
thường có kích thước 88px x 88px. - Một số hình ảnh nhất định trong cùng một loại tài nguyên vẫn có thể có kích thước hình thu nhỏ khác nhau, tuỳ 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ỏ đều có một thuộc tính
width
và một thuộc tínhheight
. Tuy nhiên, 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ỏ được tải lên không khớp với kích thước bắt buộc, thì hình ảnh đó sẽ được đổi kích thước cho phù hợp mà không làm thay đổi tỷ lệ khung hình. Hình ảnh không bị cắt, nhưng có thể có các thanh màu đen để có 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ương thức trình bày tài nguyên và danh sách thuộc tính.
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. |
VideoAbuseReportReasons
Tài nguyên videoAbuseReportReason
chứa thông tin về lý do một video bị gắn cờ do chứa nội dung sai trái. Khi ứng dụng của bạn gọi phương thức videos.reportAbuse
để báo cáo một video có hành vi sai trái, yêu cầu sẽ sử dụng thông tin từ tài nguyên videoAbuseReportReason
để xác định lý do video đó đang được báo cáo.
Để biết thêm thông tin về tài nguyên này, hãy xem phương thức trình bày tài nguyên và danh sách thuộc tính.
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 lý do có thể dùng để báo cáo video có hành vi sai trái. |
VideoCategories
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ương thức trình bày tài nguyên và danh sách thuộc tính.
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 các 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 một video trên YouTube.
Để biết thêm thông tin về tài nguyên này, hãy xem phương thức trình bày tài nguyên và danh sách thuộc tính.
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ỳ ý đặt siêu dữ liệu của 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á một 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 một video. |
getRating |
GET /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. |
reportAbuse |
POST /videos/reportAbuse |
Báo cáo video vì chứa nội dung sai trái. |
Hình mờ
Tài nguyên watermark
xác định một 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ư thông tin chi tiết về thời gian xác định thời điểm hình mờ xuất hiện trong khi phát video và thời lượng hiển thị hình mờ.
Để biết thêm thông tin về tài nguyên này, hãy xem phương thức trình bày tài nguyên và danh sách thuộc tính.
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 mờ đó cho một kênh. |
unset |
POST /watermarks/unset |
Xoá hình ảnh hình mờ của kênh. |