REST Resource: comments

资源：评论

文件评论。

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

JSON 表示法 
{
  "id": string,
  "kind": string,
  "createdTime": string,
  "modifiedTime": string,
  "resolved": boolean,
  "anchor": string,
  "replies": [
    {
      object (Reply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "htmlContent": string,
  "content": string,
  "quotedFileContent": {
    "mimeType": string,
    "value": string
  }
}
字段
id

string

仅限输出。评论的 ID。
kind

string

仅限输出。表明这是哪类资源。值：固定字符串 "drive#comment"。
createdTime

string

仅限输出。评论的创建时间（RFC 3339 日期时间）。
modifiedTime

string

仅限输出。评论或其任何回复的上次修改时间（RFC 3339 日期时间）。
resolved

boolean

仅限输出。评论是否已通过其中某条回复得到解决。
anchor

string

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

object (Reply)

仅限输出。按时间顺序显示的对该评论的完整回复列表。
author

object (User)

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

boolean

仅限输出。评论是否已删除。已删除的评论没有内容。
htmlContent

string

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

string

评论的纯文本内容。此字段用于设置内容，同时应显示 htmlContent。
quotedFileContent

object

评论所引用的文件内容，通常位于锚点区域内。例如，对于文本文件，这将是注释所在位置的文字。
quotedFileContent.mimeType

string

引用内容的 MIME 类型。
quotedFileContent.value

string

被引用的内容本身。如果通过 API 进行设置，则会被解读为纯文本。

方法

create

 在文件中创建评论。

delete

 删除评论。

get

 根据 ID 获取评论。

list

 列出文件的评论。

update

 使用补丁语义更新评论。