CommentThreads

commentThread 資源包含 YouTube 留言討論串的相關資訊，其中包含該留言的頂層留言和回覆 (如有)。commentThread 資源代表影片的留言。

頂層留言和回覆實際上都是以巢狀結構嵌入 commentThread 資源中的 comment 資源。commentThread 資源不一定會包含註解的所有回覆，如果您要擷取特定註解的所有回覆，則必須使用 comments.list 方法。部分留言沒有回覆。

方法

API 支援下列 commentThreads 資源方法：

list
傳回符合 API 要求參數的註解執行緒清單。 立即試用。
插入
建立新的頂層註解。如要在現有註解中新增回覆，請改用 comments.insert 方法。 立即試用。

資源表示法

JSON 結構會顯示 commentThreads 資源的格式：

{
  "kind": "youtube#commentThread",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "videoId": string,
    "topLevelComment": comments Resource,
    "canReply": boolean,
    "totalReplyCount": unsigned integer,
    "isPublic": boolean
  },
  "replies": {
    "comments": [
      comments Resource
    ]
  }
}

屬性

下表定義了這個資源中顯示的屬性：

屬性
kind string
識別 API 資源的類型。值為 youtube#commentThread。
etag etag
這項資源的 Etag。
id string
YouTube 用來識別留言串的 ID。
snippet object
snippet 物件包含註解執行緒的基本詳細資料。同時也包含執行緒的頂層註解，也就是 comment 資源。
snippet.channelId string
與討論串留言相關聯的 YouTube 頻道。snippet.videoId 屬性可用來識別影片。
snippet.videoId string
留言所指影片的 ID。
snippet.topLevelComment object
討論串的頂層註解。屬性值是 comment 資源。
snippet.canReply boolean
這項設定會指定目前的檢視者能否回覆討論串。
snippet.totalReplyCount unsigned integer
針對頂層留言提交的回覆總數。
snippet.isPublic boolean
這項設定可指明 YouTube 使用者是否能看見討論串，包括其所有的留言和留言回覆。
replies object
replies 物件為容器，內含註解的回覆清單 (如果有的話)。replies.comments 屬性代表註解本身的清單。
replies.comments[] list
頂層註解的一或多個回覆清單。清單中的每個項目都是 comment 資源。

此清單包含的回覆數量有限，除非清單中的項目數量等於 snippet.totalReplyCount 屬性的值，否則回覆清單只會是頂層註解可用的回覆總數的一部分。如要擷取頂層註解的所有回覆，您必須呼叫 comments.list 方法，並使用 parentId 要求參數來找出要擷取回覆的註解。