资源:注释
对文件的评论。
某些资源方法(例如 comments.update
)需要 commentId
。使用 comments.list
方法检索文件中评论的 ID。
JSON 表示法 |
---|
{ "id": string, "kind": string, "createdTime": string, "modifiedTime": string, "resolved": boolean, "anchor": string, "replies": [ { object ( |
字段 | |
---|---|
id |
仅供输出。评论的 ID。 |
kind |
仅供输出。标识这是哪类资源。值:固定字符串 |
createdTime |
仅供输出。评论的创建时间(RFC 3339 日期时间)。 |
modifiedTime |
仅供输出。上次修改评论或其任何回复的时间(RFC 3339 日期时间)。 |
resolved |
仅供输出。评论是否通过某个回复的回复得到解决。 |
anchor |
以 JSON 字符串表示的文档区域。如需详细了解如何定义锚标记属性,请参阅管理评论和回复。 |
replies[] |
仅供输出。完整评论回复列表(按时间顺序排列)。 |
author |
仅供输出。评论的作者。系统不会填充作者的电子邮件地址和权限 ID。 |
deleted |
仅供输出。评论是否已删除。已删除的评论没有任何内容。 |
htmlContent |
仅供输出。采用 HTML 格式的评论内容。 |
content |
评论的纯文本内容。此字段用于设置内容,而应显示 |
quotedFileContent |
注释所引用的文件内容,通常在锚点区域内。例如,对于文本文件,应为注释位置的文本。 |
quotedFileContent.mimeType |
引用内容的 MIME 类型。 |
quotedFileContent.value |
引用的内容本身。如果通过 API 进行设置,则会被解读为纯文本。 |
方法 |
|
---|---|
|
对文件创建评论。 |
|
删除评论。 |
|
根据 ID 获取评论。 |
|
列出文件注释。 |
|
使用补丁语义更新注释。 |