commentThread
资源包含有关 YouTube 评论会话的信息,其中包括顶级评论和对该评论的回复(如果有)。commentThread
资源表示视频收到的评论。
顶级评论和回复实际上都是嵌套在 commentThread
资源中的 comment
资源。commentThread
资源并不一定包含评论的所有回复,如果您想要检索特定评论的所有回复,则需要使用 comments.list
方法。有些评论没有回复。
方法
对于 commentThreads
资源,该 API 支持以下方法:
- list
- 返回与 API 请求参数匹配的评论会话列表。 立即试用。
- insert
- 创建新的顶级评论。如需向现有评论添加回复,请改用
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 请求参数标识您要检索回复的评论。 |