2013 年 9 月 (更新日期:2013 年 12 月 2 日)
簡介
我們在 2013 年 11 月推出新的 YouTube 評論系統,該系統採用 Google+ 技術,能讓 YouTube 使用者從每部影片獲得的留言數量比以往更多。新系統也能讓您更容易找到有意義的對話,因為留言的排序依據是與個別使用者的關聯性。
雖然 YouTube Data API 第 3 版目前不支援新留言,但您可以繼續使用舊版 API (v2),但須注意下列幾點 (以及上述好處)。
切換至新的評論系統後,建議您確認這項整合是否仍可正常運作。如果發現任何錯誤 (檔案問題,請前往 youtube.com/dev)。感謝您!
常見問題
轉換前發布的留言會發生什麼事?
在轉移前張貼的留言,改採 Google+ 技術提供的新系統。
還能使用留言動態消息嗎?
是的,舉例來說,如果您使用 API 擷取影片的留言,系統會依據這則公告中提到的相關性,為您提供留言動態饋給*。自從改用新版留言系統後,留言不再預設以時間順序排列。不過,您還是可以將 API 要求中的 orderby
參數值設為 published
,依時間排序註解,如以下範例所示:
https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?orderby=published
建議您按照標準最佳做法,使用留言動態饋給中的 next
和 previous
連結來分頁留言。這樣一來,您就能瀏覽更多留言,比起以往更能掌握情況。
如果您已明確設定 start-index
的值,透過留言動態饋給分頁 (不建議這麼做),可能會造成行為不一致的問題,而且只會收到少量註解。
更新 (2013 年 11 月 10 日):
* 根據預設,留言動態消息會按照一般關聯性排序,而非個人關聯性。換句話說,已驗證且未經驗證的留言動態饋給要求,會傳回相同的結果。這個 API 支援包含非公開文章的個人化留言動態消息,如要取得這個動態饋給,只要發出已驗證的要求,並將 API 要求中的 relevant-to-me
參數值設為 true
,如以下範例所示:
https://gdata.youtube.com/feeds/api/videos/VIDEO_ID/comments?relevant-to-me=true
是否有動態饋給呈現新動態饋給的格式?
所有留言動態消息現在都支援新格式。以下提供部分範例。
- 關聯性動態饋給:
http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true
- 按時間順序提供的動態饋給:
http://gdata.youtube.com/feeds/api/videos/9bZkp7q19f0/comments?prettyprint=true&orderby=published
我還可以透過 API 建立註解嗎?
可以,但若要使用第 2 版 API 撰寫新註解,必須滿足以下要求:
- 已驗證使用者必須將 YouTube 頻道與 Google+ 帳戶建立連結 (API 詳細資料)
- 要求必須透過 HTTPS 傳送 (目前版本的舊版用戶端程式庫支援這項設定)
如果不符合其中一項規定,API 就會傳回錯誤。
由 Google+ 技術支援的留言提供討論串功能。這對 YouTube 的留言回覆有何影響?
轉換前留下的留言回覆,現在會顯示為一般留言。此外,系統不再支援透過 YouTube API 直接回覆留言。目前無法透過 YouTube API 回覆新版留言。
針對透過 YouTube 和 Google+ 網站和應用程式回覆的 YouTube 新式留言,我們不會傳回舊版 API 的留言動態消息。不過,您可以透過 Google+ API 取得實際回覆。
如果 YouTube 留言動態饋給項目代表新式留言,則該項目會包含 <yt:googlePlusUserId>
標記。如果標記有該標記且留言有任何回覆 (只需檢查 <yt:replyCount> 元素),您就可以從項目的 <id>
標記剖析 Google+ 活動 ID。您可以使用該 ID 呼叫 Google+ API 的 comments:list 方法,擷取該則留言最近的回覆清單。
以下摘錄示範 Google+ 活動 ID (以粗體文字顯示) 在留言動態消息項目中的顯示方式:
<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>
如果我透過 YouTube API 留言,在 Google+ 上會有什麼變化?
透過 YouTube API 發表留言後,系統並不會在您的 Google+ 訊息串中產生訊息,也不會建立 Google+ 通知。
切換到新留言系統後,活動動態消息是否會繼續顯示留言?
否,暫時不要。
舊版 API 中的 SUP 是否仍可用於留言?
不可以,但請勿留言。SUP 仰賴使用者活動動態消息。由於留言已從活動動態中移除,因此不會顯示在 SUP 中。