Method: files.accessproposals.list

列出文件的 AccessProposals。注意：只有审批人才能列出文件的 AccessProposal 项。如果用户不是审批人，则返回 403。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
fileId

string

必需。请求所针对的商品的 ID。

查询参数

参数
pageToken

string

可选。访问请求列表中的延续令牌。
pageSize

integer

可选。每页的结果数

请求正文

请求正文必须为空。

响应正文

对访问权限提案列表请求的响应。

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

JSON 表示法 
{
  "accessProposals": [
    {
      object (AccessProposal)
    }
  ],
  "nextPageToken": string
}
字段
accessProposals[]

object (AccessProposal)

访问权限提案列表。此字段仅在 v3 和 v3beta 中填充。
nextPageToken

string

下一页结果的延续令牌。如果已到达结果列表的末尾，则此字段将不存在。如果令牌因任何原因被拒绝，则应将其舍弃，并从第一页结果开始重新分页。

授权范围

需要以下 OAuth 范围之一：

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

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

AccessProposal

用于处理文件上待处理的访问权限提案的“访问权限提案”资源

JSON 表示法 
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
字段
fileId

string

相应访问权限请求所涉及的文件 ID
proposalId

string

访问权限提案的 ID
requesterEmailAddress

string

提出请求的用户的电子邮件地址
recipientEmailAddress

string

接受邀请后将获得权限的用户的电子邮件地址
rolesAndViews[]

object (RoleAndView)

用于封装访问权限提案的角色和视图。
requestMessage

string

请求者向提案添加的消息
createTime

string (Timestamp format)

创建时间

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

RoleAndView

访问提案的角色和视图的封装容器。

JSON 表示法 
{
  "role": string,
  "view": string
}
字段
role

string

请求者提议的角色。未来可能会添加新值，但目前可能的值如下：* writer * commenter * reader
view

string

表示此访问权限提案的视图。仅为属于视图的提案填充。published 是唯一支持的值。