Lưu ý: Việc tuân thủ Chính sách dành cho nhà phát triển của YouTube có hướng dẫn và ví dụ để giúp bạn đảm bảo rằng ứng dụng API của mình tuân thủ các phần cụ thể trong Điều khoản và Chính sách của Dịch vụ API YouTube. Hướng dẫn này cung cấp thông tin chi tiết về cách YouTube thực thi một số khía cạnh nhất định của Điều khoản dịch vụ API nhưng hướng dẫn này không thay thế bất kỳ tài liệu hiện có nào.
Tài liệu này nêu rõ các yêu cầu tối thiểu về chức năng đối với ứng dụng API triển khai hoặc cung cấp quyền truy cập vào các tính năng cụ thể của các dịch vụ API YouTube ("Ứng dụng API").
Các yêu cầu và nguyên tắc này giúp đảm bảo rằng ứng dụng API mang đến trải nghiệm nhất quán cho người dùng, qua đó bảo vệ lợi ích của người dùng trên YouTube, chủ sở hữu nội dung và nhà quảng cáo. Các quy tắc này là một phần không thể thiếu trong Điều khoản dịch vụ của API YouTube và phải được tuân thủ trong quá trình phát triển và triển khai mọi Ứng dụng API.
Các yêu cầu trong tài liệu này có thể thay đổi để chúng tôi có thể đảm bảo người dùng có trải nghiệm tốt hơn với các tính năng hiện có của YouTube. Những chế độ cài đặt này cũng sẽ thay đổi theo các tính năng mới và cập nhật của YouTube. Đôi khi, những thay đổi đó có thể yêu cầu bạn cập nhật Ứng dụng API để giải quyết các yêu cầu mới. Nhật ký sửa đổi Điều khoản dịch vụ sẽ ghi nhận mọi thay đổi, vì vậy, vui lòng kiểm tra tài liệu đó thường xuyên hoặc đăng ký nguồn cấp dữ liệu RSS để đảm bảo rằng bạn có thể nhanh chóng tìm hiểu về những thay đổi có thể ảnh hưởng đến Ứng dụng API của mình.
Ngoài các yêu cầu trong tài liệu này, bạn nên làm theo các phương pháp hay nhất được mô tả trong Chính sách về dịch vụ API YouTube và được thảo luận ở những phần khác trong tài liệu về dịch vụ API YouTube. Ngay cả khi không bắt buộc, những phương pháp này vẫn giúp Ứng dụng API của bạn khôi phục nhanh hơn sau khi gặp lỗi và tối ưu hoá việc sử dụng hạn mức nếu họ sử dụng những dịch vụ API YouTube phân bổ hạn mức. Đồng thời, những phương pháp này giúp đảm bảo tính lành mạnh của hệ sinh thái YouTube và trên hết là mang đến trải nghiệm tốt nhất có thể cho người dùng Ứng dụng API và ứng dụng YouTube.
Trình phát được nhúng của YouTube và tính năng phát video
Các yêu cầu trong phần này liên quan cụ thể đến trình phát YouTube được nhúng. Chính sách về Dịch vụ API YouTube cũng bao gồm một số chính sách liên quan đến những Ứng dụng API phát nội dung nghe nhìn trên YouTube.
Kích thước trình phát YouTube được nhúng
Trình phát được nhúng phải có khung nhìn tối thiểu là 200px x 200px. Nếu trình phát hiển thị các nút điều khiển, thì khung nhìn phải đủ lớn để hiển thị đầy đủ các nút điều khiển mà không cần thu nhỏ khung nhìn dưới kích thước tối thiểu. Trình phát 16:9 nên có chiều rộng tối thiểu 480 pixel và chiều cao 270 pixel.
Lượt phát tự động và lượt phát theo tập lệnh
Phần này đề cập đến tính năng tự động phát. Chính sách này áp dụng cho các trình phát được nhúng trên YouTube sử dụng tham số trình phát autoplay hoặc khởi động tự động phát theo cách lập trình bằng dịch vụ API Trình phát IFrame YouTube, dịch vụ API Trình phát Android trên YouTube hoặc dịch vụ API YouTube khác.
-
Trình phát được nhúng tự động phát video phải bắt đầu phát ngay khi trang tải hoặc ngay khi trình phát được nhúng hiển thị hoàn toàn. Tuy nhiên, Ứng dụng API không được bắt đầu tự động phát cho đến khi trình phát xuất hiện và có hơn một nửa trình phát xuất hiện trên trang hoặc màn hình.
-
Một trang hoặc màn hình không được có nhiều trình phát YouTube tự động phát nội dung cùng lúc.
-
Bất kỳ hình thu nhỏ YouTube nào bắt đầu phát phải có chiều rộng tối thiểu 120 pixel và chiều cao 70 pixel.
Thuộc tính Trình phát YouTube
Các thuộc tính và thông số của trình phát YouTube, bao gồm cả việc xuất hiện thương hiệu YouTube trong trình phát, được chỉ định trong tài liệu và thông số kỹ thuật của API YouTube (https://developers.google.com/youtube). Bạn không được thay đổi trình phát YouTube mà không được mô tả rõ ràng trong tài liệu API.
Lớp phủ và khung
Bạn không được hiển thị lớp phủ, khung hình hoặc các thành phần hình ảnh khác trước bất kỳ phần nào trong trình phát được nhúng của YouTube, bao gồm cả các nút điều khiển trình phát. Tương tự như vậy, bạn không được dùng lớp phủ, khung hình hoặc các thành phần hình ảnh khác để che khuất bất kỳ phần nào của trình phát được nhúng, bao gồm cả các nút điều khiển trình phát.
Số lần di chuột qua
Bạn không được sử dụng sự kiện di chuột qua hoặc chạm vào trình phát YouTube để thực hiện bất kỳ hành động nào thay mặt người dùng, chẳng hạn như mở cửa sổ hoặc đăng ký kênh.
Tải video lên
Nếu Ứng dụng API cho phép người dùng tải nội dung lên nhiều nền tảng, thì người dùng có thể chọn và bỏ chọn các nền tảng mà họ muốn tải video lên.
Các yêu cầu về dữ liệu
Các ứng dụng API cho phép người dùng tải video lên YouTube phải cho phép người dùng đặt các giá trị trong danh sách sau đây. Bạn không bắt buộc phải thêm những cơ sở lưu trú không có trong danh sách.
| Tên | Nội dung mô tả | |
|---|---|---|
| Thuộc tính tài nguyên | ||
snippet.title |
Bắt buộc. Tiêu đề của video. YouTube trả về lỗi nếu giá trị vượt quá 100 ký tự. YouTube hỗ trợ tất cả ký tự UTF-8 hợp lệ, ngoại trừ < và >.
| |
snippet.description |
Bắt buộc. Thông tin mô tả video. YouTube trả về lỗi nếu giá trị vượt quá 5000 byte. YouTube hỗ trợ tất cả ký tự UTF-8 hợp lệ, ngoại trừ < và >. |
|
status.privacyStatus |
Bắt buộc. Chế độ cài đặt quyền riêng tư của video. Người dùng phải có quyền chọn đặt video đã tải lên ở chế độ công khai, riêng tư hay không công khai. | |
| Yêu cầu tham số | ||
onBehalfOfContentOwnerChannel |
Bắt buộc có điều kiện. Nếu thông tin uỷ quyền của yêu cầu xác định một chủ sở hữu nội dung và tham số onBehalfOfContentOwner được đặt thì người dùng API cũng phải chỉ định được kênh YouTube nơi video đang được tải lên. |
|
Đang hiển thị nhận xét
| Tên | Nội dung mô tả | |
|---|---|---|
| Thuộc tính tài nguyên | ||
snippet.textDisplay |
Bắt buộc. Nội dung của nhận xét. Ứng dụng API phải (a) hiển thị toàn bộ văn bản của một bình luận/bình luận hoặc (b) cắt ngắn văn bản và đưa ra cách để người xem dễ dàng truy cập vào toàn bộ văn bản tại phiên bản bị cắt bớt. Yêu cầu này áp dụng cho tất cả bình luận và phản hồi bình luận, bất kể bình luận liên kết với loại tài nguyên nào (video, kênh, v.v.). Xin lưu ý rằng giá trị thuộc tính snippet.topLevelComment của tài nguyên commentThread là một danh sách comment và tài nguyên replies.comments[] là một danh sách tài nguyên comment và thuộc tính replies.comments[]. Do đó, yêu cầu này cũng áp dụng cho các thuộc tính snippet.topLevelComment.snippet.textDisplay và replies.comments[].snippet.textDisplay. |
|
snippet.title( channel) |
Bắt buộc (đề xuất). Tiêu đề của kênh.
|
|
snippet.title( video) |
Bắt buộc có điều kiện (đề xuất). Tiêu đề của video. Giá trị này phải xuất hiện nếu bình luận liên quan đến một video. | |
snippet.moderationStatus |
Bắt buộc có điều kiện. Nếu giá trị tham số moderationStatus trong yêu cầu API là heldForReview hoặc likelySpam, thì màn hình phải xác định rõ trạng thái đó bằng giá trị tài sản, ngôn ngữ tương tự (ví dụ: "Bình luận này đang được giữ lại để xem xét"), tiêu đề (ví dụ: "Bị giữ lại để xem xét") hoặc ngôn từ rõ ràng khác. Phương thức commentThreads.list hỗ trợ khả năng truy xuất bình luận dựa trên trạng thái kiểm duyệt của bình luận. |
|
Đang thêm nhận xét
| Tên | Nội dung mô tả | |
|---|---|---|
| Thuộc tính tài nguyên | ||
snippet.title( channel) |
Bắt buộc. Tiêu đề của kênh.
|
|
snippet.title( video) |
Bắt buộc. Nếu người dùng đang thêm nhận xét về video, ứng dụng API phải hiển thị tiêu đề của video. | |
| Các yêu cầu khác | ||
Comment author's channel name |
Bắt buộc. Ứng dụng API phải xác định rõ ràng tài khoản người dùng YouTube sẽ gán nhận xét. Nếu thông tin xác thực uỷ quyền của yêu cầu xác định một chủ sở hữu nội dung và tham số onBehalfOfContentOwner được đặt thì người dùng API cũng phải chỉ định được kênh YouTube nơi nhận xét sẽ được gán. |
|
Thêm phản hồi bình luận
| Tên | Nội dung mô tả | |
|---|---|---|
| Thuộc tính tài nguyên | ||
snippet.textDisplay |
Bắt buộc. Nội dung của nhận xét. Ứng dụng API phải hiển thị văn bản của nhận xét mà người dùng đang trả lời theo các quy tắc được xác định trong phần Hiển thị nhận xét của tài liệu này. | |
snippet.title( channel) |
Bắt buộc. Tiêu đề của kênh.
|
|
snippet.title( video) |
Bắt buộc. Nếu người dùng đang trả lời bình luận về một video, thì ứng dụng API phải cho thấy tiêu đề của video đó. | |
| Các yêu cầu khác | ||
Comment author's channel name |
Bắt buộc. Ứng dụng API phải xác định rõ tài khoản người dùng YouTube sẽ nhận phản hồi bình luận đó. Nếu thông tin xác thực uỷ quyền của yêu cầu xác định một chủ sở hữu nội dung và tham số onBehalfOfContentOwner được đặt thì người dùng API cũng phải chỉ định được kênh YouTube sẽ nhận phản hồi bình luận. |
|
Chỉnh sửa hoặc xoá phản hồi bình luận
| Tên | Nội dung mô tả | |
|---|---|---|
| Thuộc tính tài nguyên | ||
snippet.textDisplay |
Bắt buộc. Nội dung của nhận xét. Ứng dụng API phải hiển thị văn bản của nhận xét mà người dùng đang chỉnh sửa hoặc xoá theo các quy tắc được xác định trong phần Hiện nhận xét của tài liệu này. | |
snippet.title( channel) |
Bắt buộc. Tiêu đề của kênh.
|
|
snippet.title( video) |
Bắt buộc. Nếu người dùng đang chỉnh sửa hoặc xoá nhận xét về video, ứng dụng API phải hiển thị tiêu đề của video. | |
| Các yêu cầu khác | ||
Comment author's channel name |
Bắt buộc. Ứng dụng API phải xác định rõ ràng tài khoản người dùng YouTube chứa bình luận đó. | |
Cấm người dùng trò chuyện trực tiếp (hoặc xoá lệnh cấm)
| Tên | Nội dung mô tả | |
|---|---|---|
| Thuộc tính tài nguyên | ||
snippet.title( channel) |
Bắt buộc. Tên của kênh YouTube đang bị cấm hoặc bị bỏ cấm. Ngoài ra, tên phải liên kết đến kênh hoặc URL của kênh cũng phải hiển thị. | |
| Các yêu cầu khác | ||
| Tên kênh của người viết bình luận | Bắt buộc. Ứng dụng API phải xác định rõ tài khoản người dùng YouTube đang được dùng để thêm hoặc xoá lệnh cấm. | |