Répertorier les lecteurs disponibles

Article
04/08/2023

Récupérez la liste des ressources Drive disponibles pour un utilisateur, un groupe ou un site cible.

Autorisations

L’une des autorisations suivantes est nécessaire 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, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Application	Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Répertorier les lecteurs d’un groupe

Pour répertorier les bibliothèques de documents d’un groupe, votre application demande la relation drives sur le groupe.

Requête HTTP

GET /groups/{groupId}/drives

Répertorier les lecteurs d’un site

Pour répertorier les bibliothèques de documents d’un site, votre application demande la relation drives sur le site.

GET /sites/{siteId}/drives

Répertorier les lecteurs d’un utilisateur

GET /users/{userId}/drives

Répertorier les lecteurs de l’utilisateur actuel

GET /me/drives

Paramètres facultatifs de la requête

Cette méthode prend en charge les $expandparamètres de requête , $select$skipToken, $top, et $orderbyOData pour personnaliser la réponse.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et la collection d’objets Drive dans le corps de la réponse.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "942CAEB0-13AE-491B-85E4-7557CDC0F25F",
      "driveType": "documentLibrary",
      "name": "Shared Documents",
      "owner": {
        "user": {
          "id": "AE2A1EE9-81A7-423C-ABE4-B945F47509BB",
          "displayName": "Ryan Gregg"
        }
      }
    },
    {
      "id": "C1CD3ED9-0E98-4B0B-82D3-C8FB784B9DCC",
      "driveType": "documentLibrary",
      "name": "Contoso Project Files",
      "owner": {
        "user": {
          "id": "406B2281-18E8-4416-9857-38C531B904F1",
          "displayName": "Daron Spektor"
        }
      }
    }
  ]
}

Remarques

La plupart des utilisateurs possèdent une seule ressource de disque.

Les groupes et les sites peuvent disposer de plusieurs ressources Drive.

Les lecteurs avec la facette system sont masqués par défaut. Pour les répertorier, ajoutez system à votre instruction $select.

Partager via