Freigeben über

Elemente auflisten, die für den angemeldeten Benutzer freigegeben sind

  • Artikel

Mit dieser API können Sie eine Sammlung von Ressourcen des Typs DriveItem abrufen, die für den Besitzer der Ressource des Typs Drive freigegeben wurden.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Files.Read.All, Files.ReadWrite.All
Anwendung Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Hinweis: Die /sharedWithMe-Anforderung funktioniert zwar mit Files.Read- oder Files.ReadWrite-Berechtigungen, es kann jedoch sein, dass einige Eigenschaften fehlen. Darüber hinaus kann ohne eine der Berechtigungen Alle nicht auf freigegebene Elemente zugegriffen werden, die von dieser API zurückgegeben werden.

HTTP-Anforderung

GET /me/drive/sharedWithMe

Antwort

Dadurch wird eine Sammlung von DriveItem-Ressourcen, zurückgegeben, die die DriveItem-Ressourcen enthalten, die für den Besitzer des Laufwerks freigegeben wurden. Da es sich bei dem Laufwerk um das Standardlaufwerk des Benutzers handelt, werden in diesem Beispiel Elemente zurückgegeben, die für den angemeldeten Benutzer freigegeben sind.

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"
        }
      }
    }
  ]
}

Bemerkungen

DriveItems, die von der SharedWithMe-Aktion zurückgegeben werden, enthalten immer das remoteItem-Facet, das angibt, dass es sich um Elemente von einem anderen Laufwerk handelt. Um auf die freigegebenen DriveItem Ressourcen zuzugreifen, müssen Sie eine Anforderung anhand der Angaben in remoteItem im folgenden Format stellen:

GET /drives/{remoteItem-driveId}/items/{remoteItem-id}