本文档介绍了如何在 Google Drive API 中管理审批。
您可以在 Google 云端硬盘中找到内容审批。Google Drive API 提供了 approvals 资源,以便您获取和列出审批状态。approvals 资源的方法适用于 Google 云端硬盘、Google 文档和其他 Google Workspace 编辑器中的项目。
您可以通过此流程在正式审核情形(例如合同审核或正式文档发布前审核)中查找审批。审批会跟踪审核状态(例如“进行中”“已批准”或“已拒绝”)以及涉及的审核者。审批是验证内容和记录审批人的绝佳方式。
如需查看文件的审批情况,您必须拥有读取文件元数据的权限。如需了解详情,请参阅角色和权限。
使用 fields 参数
如果您想指定要在响应中返回的字段,可以使用 approvals 资源的任何方法设置 fields 系统参数。如果您省略 fields 参数,服务器会返回一组特定于相应方法的默认字段。如需返回其他字段,请参阅返回特定字段。
获得批准
如需获取文件审批,请对 approvals 资源使用 get 方法,并提供 fileId 和 approvalId 路径参数。如果您不知道审批 ID,可以使用 list 方法列出审批。
响应正文包含 approvals 资源的实例。
列出审批
如需列出文件审批,请对 approvals 资源调用 list 方法,并添加 fileId 路径参数。
响应正文包含文件审批列表。items 字段包含有关每项审批的信息,以 approvals 资源的形式呈现。
approvals 资源还包含一个 Status 对象,用于详细说明审批状态;以及一个 ReviewerResponse 对象,用于详细说明对特定审核者做出的审批的响应。相应评价者的回答由 Response 对象表示。
您还可以传递以下查询参数,以自定义审批的分页或过滤审批:
pageSize:每页返回的审批数上限。如果您未设置pageSize,服务器最多会返回 100 个审批。pageToken:从上一个列表调用收到的页面令牌。此令牌用于检索后续页面。应将其设置为之前响应中的nextPageToken值。