检索已与驱动器所有者共享的 DriveItem 资源的集合。
权限
调用此 API 需要以下权限之一。 若要了解详细信息,包括如何选择权限的信息,请参阅权限。
| 权限类型 | 权限(从最低特权到最高特权) |
|---|---|
| 委派(工作或学校帐户) | Files.Read.All、Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All |
| 委派(个人 Microsoft 帐户) | Files.Read.All、Files.ReadWrite.All |
| 应用程序 | Files.Read.All、Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All |
注意:虽然 /sharedWithMe 请求可通过 Files.Read 或 Files.ReadWrite 权限成功发出,但一些属性可能会丢失。 此外,如果没有 “所有” 权限之一,则无法访问从此 API 返回的共享项。
HTTP 请求
GET /me/drive/sharedWithMe
响应
此方法返回 DriveItem 资源的集合,这些资源包含已与驱动器所有者共享的 DriveItem 资源。 在此示例中,由于此驱动器是用户的默认驱动器,此方法将返回与已登录用户共享的项目。
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"id": "1312abc",
"remoteItem": {
"id": "1991210caf!192",
"name": "March Proposal.docx",
"file": { },
"size": 19121,
"parentReference": {
"driveId": "1991210caf",
"id": "1991210caf!104"
}
}
},
{
"id": "1312def",
"remoteItem": {
"id": "1991210caf!1991",
"name": "Team Roster.xlsx",
"file": { },
"size": 37619,
"parentReference": {
"driveId": "1991210caf",
"id": "1991210caf!104"
}
}
}
]
}
注解
从 sharedWithMe 操作返回的 driveItem 始终都将包括 remoteItem 方面,这表明它们是其他驱动器中的项目。 若要访问共享的 DriveItem 资源,你将需要使用 remoteItem 中提供的信息发出请求,信息格式如下:
GET /drives/{remoteItem-driveId}/items/{remoteItem-id}