调用Drive.comments.list()触发GoogleJsonResponseException：需fields参数

问题原因 #

你碰到的错误是因为Google Drive API v3强制要求调用Comments.list方法时必须指定fields参数，这个参数用来明确告诉API你需要返回哪些评论相关的数据字段。你参考的旧代码大概率是基于Drive API v2写的，v2不需要这个参数，所以换到v3就会触发这个报错。

修复方案 #

直接把报错的代码行替换成带fields参数的调用就行，示例如下：

const comments = Drive.Comments.list(docId, {
  fields: 'items(content,createdDate,author/displayName,resolved,quotedFileContent/value)'
}).items;

参数说明 #

fields的值是逗号分隔的字符串，用来指定你要获取的评论字段，这里列的几个是适配你导出需求的核心字段：

• items(content)：获取评论的内容文本
• items(createdDate)：获取评论的创建时间
• items(author/displayName)：获取评论作者的显示名称
• items(resolved)：获取评论是否已解决的状态
• items(quotedFileContent/value)：获取评论关联的高亮文本（这正是你需要的关键内容）

你可以根据自己的需求调整字段列表，比如想加评论ID就添个id，想加更新时间就加updatedDate，字段之间用逗号隔开就行。

额外提醒 #

确认你的Google Apps Script项目已经正确启用了Drive API（按照你参考的问答步骤配置的话应该没问题），要是还有问题可以检查下API的权限配置是否正确。

内容的提问来源于stack exchange，提问作者rsp