Method: permissions.list
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
GET https://www.googleapis.com/drive/v3/files/{fileId}/permissions
网址采用 gRPC 转码语法。
路径参数
参数 |
fileId |
string
文件或共享云端硬盘的 ID。
|
查询参数
参数 |
pageSize |
integer
每页要返回的权限的最大数量。如果未针对共享云端硬盘中的文件设置此值,则最多返回 100 个结果。如果未针对非共享云端硬盘中的文件设置此参数,则系统会返回整个列表。
|
pageToken |
string
用于在下一页继续执行之前的列表请求的令牌。此参数应设置为上一个响应中的“nextPageToken”值。
|
supportsAllDrives |
boolean
请求访问的应用是否同时支持“我的云端硬盘”和共享云端硬盘。
|
supportsTeamDrives (deprecated) |
boolean
已弃用:请改用 supportsAllDrives 。
|
useDomainAdminAccess |
boolean
以网域管理员身份发出请求;如果设置为 true,则当文件 ID 参数引用的是共享云端硬盘,且请求者是该共享云端硬盘所属网域的管理员时,系统会向请求者授予访问权限。
|
includePermissionsForView |
string
指定要在响应中包含哪些其他视图的权限。仅支持“已发布”。
|
响应正文
文件的权限列表。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
{
"permissions": [
{
object (Permission )
}
],
"nextPageToken": string,
"kind": string
} |
字段 |
permissions[] |
object (Permission )
权限列表。如果 nextPageToken 已填充,则表示此列表可能不完整,应再提取一页结果。
|
nextPageToken |
string
下一页权限的页面令牌。如果已到达权限列表的末尾,则此字段将不存在。如果令牌因任何原因被拒绝,则应将其舍弃,并从第一页结果重新开始分页。网页令牌通常在几个小时内有效。不过,如果添加或移除了新商品,您的预期结果可能会有所不同。
|
kind |
string
表明这是哪类资源。值:固定字符串 "drive#permissionList" 。
|
授权范围
需要以下 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.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
某些范围受到限制,您的应用需要通过安全评估才能使用这些范围。如需了解详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],[],null,["# Method: permissions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.PermissionList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists a file's or shared drive's permissions.\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v3/files/{fileId}/permissions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------|\n| `fileId` | `string` The ID of the file or shared drive. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of permissions to return per page. When not set for files in a shared drive, at most 100 results will be returned. When not set for files that are not in a shared drive, the entire list will be returned. |\n| `pageToken` | `string` The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `useDomainAdminAccess` | `boolean` Issue the request as a domain administrator; if set to true, then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs. |\n| `includePermissionsForView` | `string` Specifies which additional view's permissions to include in the response. Only 'published' is supported. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of permissions for a file.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"permissions\": [ { object (/workspace/drive/api/reference/rest/v3/permissions#Permission) } ], \"nextPageToken\": string, \"kind\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `permissions[]` | `object (`[Permission](/workspace/drive/api/reference/rest/v3/permissions#Permission)`)` The list of permissions. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched. |\n| `nextPageToken` | `string` The page token for the next page of permissions. This field will be absent if the end of the permissions list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"drive#permissionList\"`. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.meet.readonly`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.photos.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]