specialFolder-Ressourcentyp

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.