Method: comments.list

列出文件的评论。如需了解详情，请参阅管理评论和回复。

必需：必须设置 fields 参数。如需返回您需要的确切字段，请参阅返回特定字段。

HTTP 请求

GET https://www.googleapis.com/drive/v3/files/{fileId}/comments

网址采用 gRPC 转码语法。

路径参数

参数
fileId

string

文件的 ID。

查询参数

参数
includeDeleted

boolean

是否包含已删除的评论。已删除的评论将不包含其原始内容。
pageSize

integer

每页返回的评论数量上限。
pageToken

string

用于在下一页上继续之前的列表请求的令牌。此参数应设为上一个响应中的“nextPageToken”值。
startModifiedTime

string

结果注释的“modifiedTime”的最小值（RFC 3339 日期时间）。

请求正文

请求正文必须为空。

响应正文

文件评论列表。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "kind": string,
  "comments": [
    {
      object (Comment)
    }
  ],
  "nextPageToken": string
}
字段
kind

string

表明这是哪类资源。值：固定字符串 "drive#commentList"。
comments[]

object (Comment)

评论列表。如果已填充 nextPageToken，则此列表可能不完整，并且应提取下一页的结果。
nextPageToken

string

下一页评论的页面令牌。如果已到达评论列表的末尾，则不会显示此属性。如果令牌因任何原因被拒绝，则应将其舍弃，并从第一页结果开始重新分页。网页令牌通常有效期为几个小时。不过，如果添加或移除新内容，预期结果可能会有所不同。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.readonly

某些镜重受限，您的应用需要接受安全评估才能使用它们。如需了解详情，请参阅授权指南。