Partager via

Répertorier les éléments partagés avec l’utilisateur connecté

  • Article

Récupérez une collection de ressources DriveItem qui ont été partagées avec le propriétaire du lecteur.

Autorisations

L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel) Files.Read.All, Files.ReadWrite.All
Application Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Remarque : bien que la demande /sharedWithMe aboutira avec des autorisations Files.Read ou Files.ReadWrite, certaines propriétés peuvent être absentes. En outre, sans l’une des autorisations Tous , les éléments partagés retournés par cette API ne seront pas accessibles.

Requête HTTP

GET /me/drive/sharedWithMe

Réponse

Ceci renvoie une collection de ressources DriveItem qui contient les ressources DriveItem partagées avec le propriétaire du lecteur. Dans cet exemple, étant donné que le lecteur est le lecteur par défaut de l’utilisateur, les éléments renvoyés sont partagés avec l’utilisateur connecté.

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

Remarques

Les objets DriveItem renvoyés par l’action sharedWithMe incluront toujours la facette remoteItem qui indique qu’ils proviennent d’un autre lecteur. Pour accéder à la ressource DriveItem partagée, vous devrez effectuer une requête en utilisant les informations fournies dans remoteItem au format suivant :

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