SpecialFolder-Ressourcentyp

  • Artikel

Die SpecialFolder-Ressource gruppiert ordnerbezogene Datenelement in einer einzelnen Struktur.

Wenn ein DriveItem über ein specialFolder-Facet ungleich Null verfügt, stellt das Element einen speziellen (benannten) Ordner dar. Auf spezielle Ordner können Sie direkt über die Sammlung spezieller Ordner zugreifen.

Spezielle Ordner bieten einfache Aliase für den Zugriff auf bekannte Ordner, ohne dass der Ordner anhand des Pfads nachgeschlagen werden muss (wofür eine Lokalisierung erforderlich wäre) oder anhand einer ID auf den Ordner verwiesen werden muss. Wenn ein spezieller Ordner umbenannt oder an eine andere Position innerhalb des Laufwerks verschoben wird, kann mit dieser Syntax weiterhin dieser Ordner zurückgegeben werden.

Spezielle Ordner werden automatisch erstellt, wenn eine Anwendung das erste Mal versucht, einen Ordner zu schreiben, wenn noch keiner vorhanden ist. Wenn ein Benutzer einen speziellen Ordner löscht, wird dieser neu erstellt, wenn erneut in den Ordner geschrieben wird.

Hinweis: Wenn Ihre App nur den Files.Read-Bereich angefordert hat und einen speziellen Ordner anfordert, der nicht vorhanden ist, wird als Antwort der Fehler 403 Forbidden zurückgegeben.

JSON-Darstellung

{
  "name": "string"
}

Eigenschaften

Eigenschaft Typ Beschreibung
name string Der eindeutige Bezeichner für dieses Element in der /drive/special-Sammlung

Spezielle Ordner

Hier sind die speziellen Ordner, die in OneDrive und OneDrive for Business verfügbar sind.

Name Ordner-ID Beschreibung
Anwendungsstamm approot Der persönliche Ordner der Anwendung. In der Regel unter /Apps/{Application Name}
Eigene Aufnahmen cameraroll Der Sicherungsordner für Eigene Aufnahmen.
Desktop desktop Der Ordner „Desktop“.
Dokumente documents Der Ordner „Dokumente“.
Musik music Der Ordner „Musik“.
Fotos photos Der Ordner „Fotos“.

Bemerkungen

Weitere Informationen über die Facets eines DriveItem finden Sie unter DriveItem.