管理审批

本文档介绍了如何在 Google Drive API 中管理审批。

您可以在 Google 云端硬盘中找到内容审批。Google Drive API 提供了 approvals 资源,以便您获取和列出审批状态。approvals 资源的方法适用于 Google 云端硬盘、Google 文档和其他 Google Workspace 编辑器中的项目。

您可以通过此流程在正式审核情形(例如合同审核或正式文档发布前审核)中查找审批。审批会跟踪审核状态(例如“进行中”“已批准”或“已拒绝”)以及涉及的审核者。审批是验证内容和记录审批人的绝佳方式。

如需查看文件的审批情况,您必须拥有读取文件元数据的权限。如需了解详情,请参阅角色和权限

使用 fields 参数

如果您想指定要在响应中返回的字段,可以使用 approvals 资源的任何方法设置 fields 系统参数。如果您省略 fields 参数,服务器会返回一组特定于相应方法的默认字段。如需返回其他字段,请参阅返回特定字段

获得批准

如需获取文件审批,请对 approvals 资源使用 get 方法,并提供 fileIdapprovalId 路径参数。如果您不知道审批 ID,可以使用 list 方法列出审批

响应正文包含 approvals 资源的实例。

列出审批

如需列出文件审批,请对 approvals 资源调用 list 方法,并添加 fileId 路径参数。

响应正文包含文件审批列表。items 字段包含有关每项审批的信息,以 approvals 资源的形式呈现。

approvals 资源还包含一个 Status 对象,用于详细说明审批状态;以及一个 ReviewerResponse 对象,用于详细说明对特定审核者做出的审批的响应。相应评价者的回答由 Response 对象表示。

您还可以传递以下查询参数,以自定义审批的分页或过滤审批:

  • pageSize:每页返回的审批数上限。如果您未设置 pageSize,服务器最多会返回 100 个审批。

  • pageToken:从上一个列表调用收到的页面令牌。此令牌用于检索后续页面。应将其设置为之前响应中的 nextPageToken 值。