Type de ressource drive
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
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 OneDrive ont 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.
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| Répertorier les lecteurs | Collection d’objets lecteur | Récupérez la liste des ressources de lecteur disponibles pour un utilisateur, un groupe ou un site cible. |
| Obtenir un lecteur | lecteur | Obtenir des métadonnées sur un lecteur. |
| Obtenir la racine d’un lecteur | driveItem | Obtenir le dossier racine d’un lecteur. |
| Répertorier les activités | Collection itemActivity | Répertorie les activités qui se sont produites sous le lecteur. |
| Répertorier les éléments suivis | Collection driveItem | Répertorie les driveItems suivis de l’utilisateur. |
| Répertorier les enfants | Collection driveItem | Répertorier les enfants du dossier racine d’un lecteur. |
| Répertorier les modifications | Collection driveItem | Répertorie les modifications apportées à tous les driveItems du lecteur. |
| Rechercher | Collection driveItem | Recherchez driveItems dans un lecteur. |
| Obtenir un dossier spécial | driveItem | Accédez à un dossier spécial par son nom canonique. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| createdBy | identitySet | Identité de l’utilisateur, de l’appareil ou de l’application qui a 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 retournent personal. OneDrive Entreprise retourne business. Les bibliothèques de documents SharePoint retournent documentLibrary. En lecture seule. |
| id | String | Identificateur unique du lecteur. En lecture seule. |
| lastModifiedBy | identitySet | Identité de l’utilisateur, de l’appareil et de l’application qui a modifié l’élément pour la dernière fois. 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. Cette propriété n’est pas retournée par défaut et doit être sélectionnée à l’aide du paramètre de $select requête. |
| system | systemFacet | Le cas échéant, 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. |
| lots | Collection driveItem | Collection de lots (albums et ensembles de plusieurs sélections partagés d’éléments). Uniquement dans OneDrive personnel. |
| suivant | Collection driveitem | Liste des éléments que suit l’utilisateur. Uniquement dans OneDrive Entreprise. |
| é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. |
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",
"following": [{"@odata.type": "microsoft.graph.driveItem"}],
"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": "string",
}