Liste itens compartilhados com o usuário conectado
Recupere uma coleção de recursos DriveItem que foram compartilhados com o proprietário de Drive.
Permissões
Uma das permissões a seguir é necessária para chamar essa API. Para saber mais, incluindo como escolher permissões, confira Permissões.
Tipo de permissão | Permissões (da com menos para a com mais privilégios) |
---|---|
Delegado (conta corporativa ou de estudante) | Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Files.Read.All, Files.ReadWrite.All |
Aplicativo | Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All |
Observação: embora a solicitação /sharedWithMe tenha êxito com as permissões Files.Read ou Files.ReadWrite, algumas propriedades podem estar ausentes. Além disso, sem uma das permissões All , os itens compartilhados retornados dessa API não estarão acessíveis.
Solicitação HTTP
GET /me/drive/sharedWithMe
Resposta
Isso retorna uma coleção de recursos DriveItem que contêm DriveItem recursos compartilhados com o proprietário da unidade. Neste exemplo, como a unidade é a do usuário padrão, isso retorna itens compartilhados com o usuário conectado.
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"
}
}
}
]
}
Comentários
DriveItems retornados da ação sharedWithMe sempre incluirão a faceta remoteItem, que indica que são itens de uma unidade diferente. Para acessar o recurso compartilhado DriveItem, você precisará fazer uma solicitação usando as informações fornecidas em remoteItem no seguinte formato:
GET /drives/{remoteItem-driveId}/items/{remoteItem-id}