Partager via


Type de ressource SpecialFolder

La ressource SpecialFolder regroupe les éléments de données liés aux dossiers spéciaux dans une structure unique.

Si un objet DriveItem a une facette specialFolder non null, l’élément représente un dossier (nommé) spécial. 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.

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.

Représentation JSON

{
  "name": "string"
}

Propriétés

Propriété Type Description
name chaîne Identificateur unique de cet élément dans la collection /drive/special

Dossiers spéciaux

Voici les dossiers spéciaux disponibles dans OneDrive et OneDrive Entreprise.

Nom Identificateur de dossier Description
Racine de l’application approot Le dossier personnel de l’application. Généralement dans /Apps/{Application Name}
Pellicule cameraroll Dossier de sauvegarde de la pellicule.
Bureau desktop Dossier Bureau.
Documents documents Dossier Documents.
Musique music Dossier Musique.
Photos photos Dossier Photos.

Remarques

Pour plus d’informations sur les facettes sur un objet DriveItem, voir DriveItem.