Type de ressource drive
La ressource de lecteur est l’objet de niveau supérieur qui représente une bibliothèque de documents ou OneDrive d’un utilisateur dans SharePoint.
Les utilisateurs de OneDrive auront toujours au moins un lecteur disponible, leur lecteur par défaut. Les utilisateurs sans licence OneDrive peuvent ne pas avoir de lecteur par défaut disponible.
Représentation JSON
Voici une représentation JSON d’une ressource Drive.
La ressource drive est dérivée de l’élément baseItem et hérite des propriétés de cette ressource.
{
"activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
"id": "string",
"createdBy": { "@odata.type": "microsoft.graph.identitySet" },
"createdDateTime": "string (timestamp)",
"description": "string",
"driveType": "personal | business | documentLibrary",
"items": [ { "@odata.type": "microsoft.graph.driveItem" } ],
"lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
"lastModifiedDateTime": "string (timestamp)",
"name": "string",
"owner": { "@odata.type": "microsoft.graph.identitySet" },
"quota": { "@odata.type": "microsoft.graph.quota" },
"root": { "@odata.type": "microsoft.graph.driveItem" },
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
"special": [ { "@odata.type": "microsoft.graph.driveItem" }],
"system": { "@odata.type": "microsoft.graph.systemFacet" },
"webUrl": "url"
}
Propriétés
| Propriété | Type | Description |
|---|---|---|
| createdBy | identitySet | Identité de l’utilisateur, de l’appareil et de l’application qui ont créé l’élément. En lecture seule. |
| createdDateTime | dateTimeOffset | Date et heure de création de l’élément. En lecture seule. |
| description | String | Fournit une description du lecteur visible par l’utilisateur. En lecture-écriture. |
| driveType | Chaîne | Décrit le type de lecteur représenté par cette ressource. Les lecteurs personnels OneDrive renverront personal. OneDrive Entreprise renverra business. Les bibliothèques de documents SharePoint renverront documentLibrary. En lecture seule. |
| id | String | Identificateur unique du lecteur. En lecture seule. |
| lastModifiedBy | identitySet | Identité de l’utilisateur, du périphérique et de l’application qui ont modifié l’élément en dernier. En lecture seule. |
| lastModifiedDateTime | dateTimeOffset | Date et heure de la dernière modification de l’élément. En lecture seule. |
| name | string | Nom de l’élément. En lecture-écriture. |
| owner | identitySet | Facultatif. Compte d’utilisateur qui possède le lecteur. En lecture seule. |
| quota | quota | Facultatif. Informations sur le quota d’espace de stockage du lecteur. En lecture seule. |
| sharepointIds | sharepointIds | Renvoie les identificateurs utiles pour garantir la compatibilité de SharePoint REST. En lecture seule. |
| system | systemFacet | Si la propriété est présente, elle indique qu’il s’agit d’un lecteur géré par le système. En lecture seule. |
| webUrl | chaîne (URL) | URL qui affiche la ressource dans le navigateur. En lecture seule. |
Relations
| Relation | Type | Description |
|---|---|---|
| activities | Collection itemActivity | Liste des activités récentes qui ont eu lieu sur ce lecteur. |
| éléments | Collection DriveItem | Tous les éléments contenus dans le lecteur. En lecture seule. Peut avoir la valeur Null. |
| root | DriveItem | Dossier racine du lecteur. En lecture seule. |
| special | Collection DriveItem | Collection de dossiers courants disponibles dans OneDrive. En lecture seule. Pouvant accepter la valeur Null. |
| liste | List | Pour les lecteurs dans SharePoint, la liste de bibliothèques de documents sous-jacente. En lecture seule. Pouvant accepter la valeur Null. |
Méthodes
| Tâche courante | Méthode HTTP |
|---|---|
| Obtenir des métadonnées Drive d’un autre Drive | GET /drives/{drive-id} |
| Obtenir le dossier racine pour le Drive par défaut de l’utilisateur | GET /drive/root |
| Répertorier les activités sur le lecteur | GET /drive/activities |
| Répertorier les enfants sous le Drive | GET /drive/root/children |
| Répertorier les changements pour tous les éléments dans le Drive | GET /drive/root/delta |
| Rechercher des éléments dans le Drive | GET /drive/root/search |
| Accéder au dossier spécial | GET /drive/special/{name} |
Dans le tableau précédent, les exemples utilisent le chemin d’accès /drive, mais les autres sont tout aussi valides.