REST Resource: comments

资源：评论

Google 云端硬盘中对文件的评论。

某些资源方法（例如 comments.update）需要 commentId。使用 comments.list 方法检索文件中评论的 ID。

JSON 表示法 
{
  "commentId": string,
  "kind": string,
  "createdDate": string,
  "modifiedDate": string,
  "fileId": string,
  "status": string,
  "anchor": string,
  "replies": [
    {
      object (CommentReply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "selfLink": string,
  "htmlContent": string,
  "content": string,
  "context": {
    "type": string,
    "value": string
  },
  "fileTitle": string
}
字段
commentId

string

仅限输出。评论的 ID。
kind

string

仅限输出。此值始终为 drive#comment。
createdDate

string

仅限输出。此评论的首次创建日期。
modifiedDate

string

仅限输出。此评论或其任何回复的上次修改日期。
fileId

string

仅限输出。此评论所涉及的文件。
status

string

仅限输出。此评论的状态。您可以通过发布包含所需状态的评论回复来更改状态。

  • open - 评论仍处于开放状态。
  • resolved - 评论已通过其中一个回复得到解决。
anchor

string

文档的某个区域，表示为 JSON 字符串。如需详细了解如何定义锚点属性，请参阅添加评论和回复。
replies[]

object (CommentReply)

仅限输出。对此帖子的回复。
author

object (User)

仅限输出。评论的作者。系统不会填充作者的电子邮件地址和权限 ID。
deleted

boolean

仅限输出。评论是否已删除。如果评论已被删除，其内容将被清除，并且只会显示该评论曾经存在。
htmlContent

string

仅限输出。此评论的 HTML 格式内容。
content

string

用于创建此评论的纯文本内容。这不符合 HTML 安全要求，只能作为修改评论内容的起点。
context

object

要添加评论的文件的上下文。
context.type

string

上下文摘要的 MIME 类型。
context.value

string

被添加注释的文件片段的数据表示法。例如，对于文本文件，这将是评论所涉及的实际文本。
fileTitle

string

仅限输出。此评论所涉及的文件的标题。

方法

delete

 删除评论。

get

 根据 ID 获取评论。

insert

 在给定文件中创建新评论。

list

 列出文件的评论。

patch

 更新现有评论。

update

 更新现有评论。