资源:注释
对 Google 云端硬盘中的文件发表评论。
某些资源方法(例如 comments.update
)需要 commentId
。使用 comments.list
方法检索文件中评论的 ID。
JSON 表示法 |
---|
{ "commentId": string, "kind": string, "createdDate": string, "modifiedDate": string, "fileId": string, "status": string, "anchor": string, "replies": [ { object ( |
字段 | |
---|---|
commentId |
仅供输出。评论的 ID。 |
kind |
仅供输出。始终为 |
createdDate |
仅供输出。首次创建此评论的日期。 |
modifiedDate |
仅供输出。此评论或其任意回复的上次修改日期。 |
fileId |
仅供输出。此评论指向的文件。 |
status |
仅供输出。此评论的状态。对具有所需状态的评论发布回复即可更改状态。
|
anchor |
以 JSON 字符串表示的文档区域。如需详细了解如何定义锚标记属性,请参阅添加评论和回复。 |
replies[] |
仅供输出。对此帖子的回复。 |
author |
仅供输出。评论的作者。系统不会填充作者的电子邮件地址和权限 ID。 |
deleted |
仅供输出。此评论是否已删除。如果评论已删除,其内容将会被清除,仅代表存在过的评论。 |
selfLink |
仅供输出。指向此评论的链接。 |
htmlContent |
仅供输出。此评论的 HTML 格式的内容。 |
content |
用于创建此评论的纯文本内容。这并非 HTML 安全内容,只能用作修改评论内容的起点。 |
context |
要接受评论的文件的上下文。 |
context.type |
上下文片段的 MIME 类型。 |
context.value |
所评论的文件段的数据表示形式。例如,对于文本文件,则是评论所涉及的实际文本。 |
fileTitle |
仅供输出。此评论指向的文件的标题。 |
方法 |
|
---|---|
|
删除评论。 |
|
根据 ID 获取评论。 |
|
对指定文件创建新评论。 |
|
列出文件注释。 |
|
更新现有评论。 |
|
更新现有评论。 |