Lưu ý: Bài viết Tuân thủ Chính sách dành cho nhà phát triển của YouTube cung cấp 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 (API TOS). 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 của Điều khoản dịch vụ của API, nhưng không thay thế bất kỳ tài liệu hiện có nào.
Tài liệu này xác định các yêu cầu chức năng tối thiểu đố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 dịch vụ API YouTube ("Ứng dụng API").
Các yêu cầu và nguyên tắc này đảm bảo rằng ứng dụng API mang lại trải nghiệm nhất quán cho người dùng, đồng thời bảo vệ quyền lợi của người dùng 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à bạn phải tuân thủ các quy tắc này trong quá trình phát triển và triển khai mọi Ứng dụng API.
Bạn nên dự kiến các yêu cầu trong tài liệu này sẽ thay đổi để chúng tôi có thể đảm bảo trải nghiệm tốt hơn cho người dùng với các tính năng hiện có trên YouTube. Các tiêu chí này cũng sẽ thay đổi theo các tính năng mới và tính năng được cập nhật trên YouTube. Đôi khi, những thay đổi như vậy có thể yêu cầu bạn cập nhật Ứng dụng khách 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 lại mọi thay đổi. Vì vậy, vui lòng thường xuyên kiểm tra tài liệu đó hoặc đăng ký nguồn cấp dữ liệu RSS của tài liệu đó để đảm bảo 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 ở các phần khác trong tài liệu về dịch vụ API YouTube. Ngay cả khi không bắt buộc, các 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 lỗi và tối ưu hoá mức sử dụng hạn mức nếu ứng dụng sử dụng các 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 trạng ổn định của hệ sinh thái YouTube và quan trọng nhất là mang lại trải nghiệm tốt nhất có thể cho người dùng Ứng dụng YouTube và Ứng dụng API của bạn.
Trình phát được nhúng của YouTube và 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 của YouTube cũng bao gồm một số chính sách liên quan đến Ứng dụng API phát nội dung nghe nhìn trên YouTube.
Kích thước của 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ì trình phát phải đủ lớn để hiển thị đầy đủ các nút điều khiển mà không làm thu nhỏ khung nhìn xuống dưới kích thước tối thiểu. Bạn nên sử dụng trình phát 16:9 có chiều rộng tối thiểu 480 pixel và chiều cao tối thiểu 270 pixel.
Tự động phát và phát theo tập lệnh
Phần này đề cập đến tính năng phát tự động. Chính sách này áp dụng cho những trình phát được nhúng của YouTube sử dụng tham số trình phát autoplay hoặc bắt đầu phát tự động theo lập trình bằng cách sử dụng dịch vụ API Trình phát IFrame của YouTube hoặc một dịch vụ API khác của YouTube.
-
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ị đầy đủ. Tuy nhiên, Ứng dụng API không được bắt đầu phát tự động cho đến khi trình phát hiển thị và hơn một nửa trình phát hiển thị 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.
-
Mọi hình thu nhỏ trên YouTube có thể kích hoạt chế độ phát phải có chiều rộng tối thiểu 120 pixel và chiều cao tối thiểu 70 pixel.
Thuộc tính của Trình phát YouTube
Các thuộc tính và thông số của trình phát YouTube (ví dụ: giao diệ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 thực hiện những thay đổi đối với trình phát YouTube mà tài liệu API không mô tả rõ ràng.
Lớp phủ và khung
Bạn không được hiển thị lớp phủ, khung hoặc các thành phần hình ảnh khác trước bất kỳ phần nào của 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ự, bạn không được sử dụng lớp phủ, khung 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 hoặc sự kiện chạm trên trình phát YouTube để thay mặt người dùng thực hiện bất kỳ hành động nào, 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 phải có thể chọn và bỏ chọn những nền tảng mà họ muốn tải video lên.
Yêu cầu dữ liệu
Ứ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. Bạn không bắt buộc phải cung cấp bất kỳ thuộc tính nào không có trong danh sách.
| Tên | Mô tả | |
|---|---|---|
| Thuộc tính tài nguyên | ||
snippet.title |
Bắt buộc. Tiêu đề của video. YouTube sẽ 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. Phần mô tả video. YouTube sẽ trả về lỗi nếu giá trị vượt quá 5.000 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ó thể chọn đặt video tải lên ở chế độ công khai, riêng tư hoặc không công khai. | |
| Thông số yêu cầu | ||
onBehalfOfContentOwnerChannel |
Bắt buộc có điều kiệ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 có thể chỉ định kênh YouTube mà video đang được tải lên. |
|
Hiển thị bình luận
| Tên | Mô tả | |
|---|---|---|
| Thuộc tính tài nguyên | ||
snippet.textDisplay |
Bắt buộc. Văn bản của bình luận. Ứ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 hoặc phản hồi bình luận, hoặc (b) cắt bớt văn bản và cung cấp cách để người xem dễ dàng truy cập vào toàn bộ văn bản từ phiên bản đã 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 được 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 tài nguyên comment và thuộc tính replies.comments[] là danh sách các tài nguyên comment. 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ị thông số moderationStatus trong yêu cầu API là heldForReview hoặc likelySpam, thì màn hình hiển thị phải xác định rõ trạng thái đó bằng cách sử dụng giá trị thuộc tính, 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ụ: "Đang được giữ lại để xem xét") hoặc ngôn ngữ 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. |
|
Thêm nhận xét
| Tên | 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 bình luận về một video, thì ứ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õ tài khoản người dùng YouTube mà bình luận sẽ được phân bổ. 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 có thể chỉ định kênh YouTube mà bình luận sẽ được phân bổ. |
|
Thêm câu trả lời bình luận
| Tên | Mô tả | |
|---|---|---|
| Thuộc tính tài nguyên | ||
snippet.textDisplay |
Bắt buộc. Văn bản của bình luận. Ứng dụng API phải hiển thị văn bản của bình luận 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ị bình luận 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 một bình luận về một video, thì ứ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õ tài khoản người dùng YouTube mà nội dung trả lời bình luận sẽ được phân bổ. 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 có thể chỉ định kênh YouTube mà phản hồi bình luận sẽ được phân bổ. |
|
Chỉnh sửa hoặc xoá nội dung trả lời bình luận
| Tên | Mô tả | |
|---|---|---|
| Thuộc tính tài nguyên | ||
snippet.textDisplay |
Bắt buộc. Văn bản của bình luận. Ứ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 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 chỉnh sửa hoặc xoá bình luận về một video, thì ứ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õ tài khoản người dùng YouTube được phân bổ bình luận. | |
Cấm người dùng tham gia cuộc trò chuyện trực tiếp (hoặc gỡ bỏ lệnh cấm)
| Tên | 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 được gỡ bỏ lệnh 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 xuất hiện. | |
| Các yêu cầu khác | ||
| Tên kênh của tác giả 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. | |