Comments

comment 资源包含有关单个 YouTube 评论的信息。comment 资源可以表示有关视频或频道的评论。此外，该评论可以是顶级评论，也可以是对顶级评论的回复。

方法

该 API 支持以下适用于 comments 资源的方法：

list
返回与 API 请求参数匹配的评论列表。 立即试用。
insert
创建对现有评论的回复。注意：如需创建顶级评论，请使用 commentThreads.insert 方法。 立即试用。
update
修改评论。 立即试用。
delete
删除评论。 立即试用。
setModerationStatus
设置一条或多条评论的审核状态。API 请求必须获得与评论相关联的频道或视频的所有者的授权。 立即试用。

资源表示法

以下 JSON 结构显示了 comments 资源的格式：

{
  "kind": "youtube#comment",
  "etag": etag,
  "id": string,
  "snippet": {
    "authorDisplayName": string,
    "authorProfileImageUrl": string,
    "authorChannelUrl": string,
    "authorChannelId": {
      "value": string
    },
    "channelId": string,
    "textDisplay": string,
    "textOriginal": string,
    "parentId": string,
    "canRate": boolean,
    "viewerRating": string,
    "likeCount": unsigned integer,
    "moderationStatus": string,
    "publishedAt": datetime,
    "updatedAt": datetime
  }
}

属性

下表定义了此资源中显示的属性：

属性
kind string
用于标识 API 资源的类型。该值为 youtube#comment。
etag etag
相应资源的 ETag。
id string
YouTube 用于唯一标识评论的 ID。
snippet object
snippet 对象包含有关评论的基本详细信息。
snippet.authorDisplayName string
发布评论的用户的显示名称。
snippet.authorProfileImageUrl string
发表评论的用户的头像网址。
snippet.authorChannelUrl string
评论者的 YouTube 频道的网址（如有）。
snippet.authorChannelId object
此对象封装了评论作者的 YouTube 频道的相关信息（如有）。
snippet.authorChannelId.value string
评论者的 YouTube 频道的 ID（如有）。
snippet.channelId string
与评论相关联的 YouTube 频道的 ID。
snippet.textDisplay string
评论的文本。可以检索纯文本或 HTML 格式的文本。（comments.list 和 commentThreads.list 方法都支持 textFormat 参数，用于指定所选的文本格式。）

即使是纯文本也可能与原始评论文本不同。例如，它可能会将视频链接替换为视频标题。
snippet.textOriginal string
评论的原始纯文本，即评论最初发布或上次更新时的文本。只有经过身份验证的用户是相应评论的作者时，系统才会向其返回原始文本。
snippet.parentId string
父评论的唯一 ID。仅当评论是作为对另一条评论的回复提交时，才会设置此属性。
snippet.canRate boolean
此设置用于指明当前查看者是否可以对评论进行评分。
snippet.viewerRating string
观看者对此评论给出的评分。此属性不会标识 dislike 评分，但此行为可能会发生变化。与此同时，如果观看者对评论给出了好评，则该属性的值为 like。在所有其他情况下，该值为 none，包括用户对评论给出了负面评分或未对评论进行评分。

此属性的有效值为：
  • like
  • none
snippet.likeCount unsigned integer
相应评论获得的点赞（正面评价）总数。
snippet.moderationStatus string
评论的审核状态。仅当 API 请求已获得频道或视频所有者的授权时，系统才会返回此属性，频道或视频所有者是指发表所请求评论的频道或视频的所有者。此外，如果 API 请求使用了 id 过滤条件参数，则不会设置此属性。

此属性的有效值为：
  • heldForReview
  • likelySpam
  • published
  • rejected
snippet.publishedAt datetime
评论的原始发布日期和时间。该值采用 ISO 8601 格式指定。
snippet.updatedAt datetime
相应评论最后更新的日期和时间。该值采用 ISO 8601 格式指定。