REST Resource: comments

资源：Comment

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

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

string

评论的 ID。
kind

string

这始终为 drive#comment。
createdDate

string

相应评论的首次创建日期。
modifiedDate

string

相应评论或其任何回复的上次修改日期。
fileId

string

相应评论所针对的文件。
fileTitle

string

相应评论所针对的文件的标题。
status

string

相应评论的状态。您可以通过发布具有所需状态的评论回复来更改状态。可能的值包括：

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

string

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

object (CommentReply)

对此帖子的回复。
author

object (User)

撰写相应评论的用户。
deleted

boolean

相应评论是否已被删除。如果评论已被删除，则内容将被清除，并且此对象仅表示曾经存在的评论。
htmlContent

string

相应评论的 HTML 格式内容。
content

string

用于创建相应评论的纯文本内容。此属性不安全，仅应作为修改评论内容的起点。
context

object

被评论文件的上下文。
context.type

string

上下文片段的 MIME 类型。
context.value

string

正在添加注释的文件片段的数据表示形式。例如，对于文本文件，这会是评论所针对的实际文本。

方法

delete

 删除评论。

get

 根据 ID 获取评论。

insert

 为指定文件创建新评论。

list

 列出文件的评论。

patch

 更新现有评论。

update

 更新现有评论。