Thay đổi về bình luận trong API Dữ liệu YouTube phiên bản cũ 2

Jeremy Walker, Nhóm API YouTube
Tháng 9 năm 2013 (cập nhật ngày 2/12/2013)

Giới thiệu

Hệ thống bình luận mới của YouTube được ra mắt vào tháng 11 năm 2013 và được cung cấp bởi Google+. Nhờ đó, người dùng YouTube có thể truy xuất nhiều bình luận hơn trên mỗi video so với trước đây. Hệ thống mới cũng giúp bạn dễ dàng tìm thấy các cuộc trò chuyện có ý nghĩa hơn, vì các bình luận được sắp xếp theo mức độ liên quan đến từng người dùng.

Mặc dù YouTube Data API phiên bản 3 hiện không hỗ trợ tính năng bình luận mới, nhưng bạn vẫn có thể sử dụng phiên bản cũ hơn của API này (phiên bản 2) cùng với một số lưu ý được nêu bên dưới (và các lợi ích nêu trên).

Bạn nên xác nhận rằng quá trình tích hợp của bạn vẫn hoạt động bình thường vì chúng tôi đã chuyển sang hệ thống nhận xét mới và thông báo cho chúng tôi nếu bạn gặp bất kỳ lỗi nào (vấn đề về tệp tại youtube.com/dev). Cảm ơn bạn!

Câu hỏi thường gặp

Điều gì đã xảy ra với các bình luận được đăng trước khi chuyển đổi?

Những bình luận được đăng trước khi chuyển đổi đã được di chuyển sang hệ thống mới do Google+ cung cấp.

Trang bình luận có còn hoạt động không?

Có, ví dụ: nếu sử dụng API để truy xuất bình luận về một video, bạn sẽ nhận được nguồn cấp dữ liệu bình luận được sắp xếp theo mức độ liên quan như đã nêu trong thông báo.* Kể từ khi chuyển sang hệ thống bình luận mới, theo mặc định, các bình luận không còn được sắp xếp theo thứ tự thời gian nữa. Tuy nhiên, bạn vẫn có thể sắp xếp các nhận xét theo trình tự thời gian bằng cách đặt giá trị của tham số orderby thành published trong yêu cầu API như trong ví dụ sau:

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=published

Bạn nên làm theo phương pháp hay nhất tiêu chuẩn để sử dụng đường liên kết next và previous trong nguồn cấp dữ liệu bình luận đến trang thông qua phần bình luận. Bằng cách này, bạn cũng sẽ có thể xem qua nhiều bình luận hơn so với trước đây.

Nếu bạn đặt rõ ràng một giá trị cho start-index cho các trang thông qua nguồn cấp dữ liệu bình luận (không nên làm), thì hành vi không nhất quán có thể sẽ xảy ra và bạn sẽ chỉ nhận được một số ít bình luận được trả về.

Nội dung cập nhật (10/11/2013):

* Theo mặc định, nguồn cấp dữ liệu bình luận được sắp xếp theo mức độ liên quan chung, chứ không phải mức độ phù hợp với cá nhân. Nói cách khác, yêu cầu nguồn cấp dữ liệu bình luận đã xác thực và chưa được xác thực sẽ trả về cùng một kết quả. API này hỗ trợ nguồn cấp dữ liệu bình luận được cá nhân hoá có chứa các bài đăng không công khai. Để nhận nguồn cấp dữ liệu này, bạn chỉ cần tạo một yêu cầu đã xác thực và đặt giá trị của tham số relevant-to-me thành true trong yêu cầu API như trong ví dụ sau: 

https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?relevant-to-me=true

Có nguồn cấp dữ liệu nào minh hoạ định dạng của nguồn cấp dữ liệu mới không?

Tất cả nguồn cấp dữ liệu bình luận hiện đã hỗ trợ định dạng mới. Dưới đây là một số ví dụ.

  • Nguồn cấp dữ liệu dựa trên mức độ liên quan: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
  • Nguồn cấp dữ liệu theo trình tự thời gian: 
    http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published

Tôi vẫn có thể tạo bình luận thông qua API không?

Có, nhưng để viết nhận xét mới bằng API phiên bản 2, bạn cần đáp ứng một số yêu cầu:

  1. Người dùng đã xác thực phải có kênh YouTube được liên kết với tài khoản Google+ (thông tin chi tiết về API)
  2. Yêu cầu phải được gửi qua HTTPS (các phiên bản hiện tại của thư viện ứng dụng cũ hỗ trợ việc này theo mặc định)

Nếu không đáp ứng một trong hai yêu cầu này, API sẽ trả về lỗi.

Tạo chuỗi cung cấp nhận xét do Google+ hỗ trợ. Điều này có ý nghĩa gì đối với câu trả lời bình luận trên YouTube?

Giờ đây, các bình luận phản hồi được tạo trước khi chuyển đổi sẽ xuất hiện dưới dạng bình luận thông thường. Ngoài ra, chúng tôi không còn hỗ trợ tính năng trả lời trực tiếp bình luận thông qua API YouTube. Tại thời điểm này, không có cách nào để phản hồi bình luận kiểu mới thông qua API YouTube.

Nguồn cấp dữ liệu bình luận của API cũ không trả về các bình luận phản hồi kiểu mới trên YouTube thông qua các trang web và ứng dụng YouTube và Google+. Tuy nhiên, bạn có thể nhận được câu trả lời thực tế thông qua API Google+.

Nếu một mục trong nguồn cấp dữ liệu bình luận trên YouTube đại diện cho một bình luận kiểu mới, thì mục đó sẽ chứa thẻ <yt:googlePlusUserId>. Nếu có thẻ đó và nhận xét có bất kỳ câu trả lời nào (chỉ cần kiểm tra phần tử <yt:replyCount>), bạn có thể phân tích cú pháp ID hoạt động trên Google+ từ thẻ <id> của mục nhập. Bạn có thể sử dụng mã nhận dạng đó để gọi phương thức comments:list của API Google+ nhằm truy xuất danh sách các câu trả lời gần đây cho nhận xét đó.

Phần trích dẫn dưới đây minh hoạ cách mã hoạt động trên Google+ (hiển thị bằng văn bản in đậm) xuất hiện trong mục nhập của nguồn cấp dữ liệu bình luận:

<entry>
  <id>tag:youtube,2008:video:xpI6VNvRTII:comment:z13rtnibotmidjggs04cdvzgvurngv3pwnw0k</id>
  <yt:googlePlusUserId>123456789</yt:googlePlusUserId>
  <yt:replyCount>4</yt:replyCount>
  <yt:channelId>UCxxxx_xxxxx</yt:channelId>
  ...
</entry>

Điều gì sẽ xảy ra trên Google+ khi tôi bình luận thông qua API YouTube?

Việc bình luận thông qua API YouTube sẽ không tạo ra bài đăng trong luồng trên Google+ cũng như không tạo thông báo trên Google+.

Các bình luận có tiếp tục xuất hiện trong nguồn cấp dữ liệu hoạt động kể từ khi chuyển sang hệ thống bình luận mới không?

Không, để sau.

SUP trong API cũ có tiếp tục hoạt động cho các nhận xét không?

Không, không phải đối với bình luận. SUP dựa vào nguồn cấp dữ liệu hoạt động của người dùng. Vì bình luận không còn xuất hiện trong nguồn cấp dữ liệu hoạt động nên chúng sẽ không xuất hiện trong SUP.