Type de ressource specialFolder
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 .
Regroupe des éléments de données spéciaux liés à un dossier dans une structure unique.
Si un élément driveItem a une facette specialFolder non null, l’élément représente un dossier spécial (nommé). Vous pouvez accéder aux dossiers spéciaux directement via la collection de dossiers spéciaux.
Les dossiers spéciaux fournissent des alias simples pour accéder aux dossiers connus sans avoir besoin de rechercher le dossier par le chemin d’accès (ce qui nécessiterait la localisation) ou référencent le dossier avec un ID. Si un dossier spécial est renommé ou déplacé vers un autre emplacement dans le lecteur, cette syntaxe continuera à renvoyer ce dossier.
Les dossiers spéciaux sont créés automatiquement la première fois qu’une application tente d’écrire dans un dossier, s’il n’existe pas encore. Si un utilisateur supprime un dossier, il est recréé lorsqu’une application écrit à nouveau dans ce dossier.
Les noms de dossiers spéciaux suivants sont disponibles dans OneDrive et OneDrive Entreprise.
| Nom | Identificateur de dossier | Description |
|---|---|---|
| Documents | documents |
Dossier Documents. |
| Photos | photos |
Dossier Photos. |
| Pellicule | cameraroll |
Dossier de sauvegarde de la pellicule. |
| Racine de l’application | approot |
Le dossier personnel de l’application. Généralement dans /Apps/{Application Name}. |
| Musique | music |
Dossier Musique. |
| Enregistrements | recordings |
Dossier Enregistrements. Cette option est disponible uniquement dans OneDrive Entreprise et SharePoint Online. |
Remarque : Si votre application a demandé l’étendue Files.Read uniquement et demande un dossier spécial qui n’existe pas, la réponse sera une erreur
403 Forbidden.
Propriétés
| Propriété | Type | Description |
|---|---|---|
| name | chaîne | Identificateur unique de cet élément dans la collection /drive/special |
Représentation JSON
{
"name": "string"
}
Contenu connexe
Pour plus d’informations sur les facettes d’un objet driveItem, consultez driveItem.