specialFolder-Ressourcentyp

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Gruppiert spezielle ordnerbezogene Datenelemente in einer einzelnen Struktur.

Wenn ein driveItem-Element ü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.

Die folgenden speziellen Ordnernamen sind in OneDrive und OneDrive for Business verfügbar.

Name Ordner-ID Beschreibung
Dokumente documents Der Ordner „Dokumente“.
Fotos photos Der Ordner „Fotos“.
Eigene Aufnahmen cameraroll Der Sicherungsordner für Eigene Aufnahmen.
Anwendungsstamm approot Der persönliche Ordner der Anwendung. Normalerweise in /Apps/{Application Name}.
Musik music Der Ordner „Musik“.
Aufnahmen recordings Der Ordner "Aufzeichnungen". Diese Option ist nur in OneDrive for Business und SharePoint Online verfügbar.

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.

Eigenschaften

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

JSON-Darstellung

{
  "name": "string"
}

Verwandte Inhalte

Weitere Informationen zu den Facets eines driveItem-Objekts finden Sie unter driveItem.