Speziellen Ordner nach Name abrufen

Verwenden Sie spezielle Auflistung, um auf einen speziellen Ordner basierend auf dem Namen zuzugreifen.

Spezielle Ordner bieten einfache Aliase für den Zugriff auf bekannte Ordner in OneDrive, 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 nach diesem Ordner gesucht 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 Sie über schreibgeschützte Berechtigungen verfügen und einen speziellen Ordner anfordern, der nicht vorhanden ist, erhalten Sie eine 403 Forbidden Fehlermeldung.

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Files.ReadWrite.AppFolder, Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Anwendung	Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-Anforderung

GET /me/drive/special/{special-folder-name}

Namen für spezielle Ordner

Im Folgenden sind Namen für spezielle Ordner aufgelistet, die in OneDrive und OneDrive for Business zur Verfügung stehen.

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“.

Optionale Abfrageparameter

Diese Methode unterstützt die $expandOData-Abfrageparameter und $select zum Anpassen der Antwort.

HTTP-Antwort

Die Methode gibt den Antwortcode 200 OK und das aktualisierte driveItem-Objekt im Antworttext zurück.

Sie können diese Methode der Adressierung eines speziellen Ordners mit dem zusätzlichen Aufruf der Eigenschaften oder Beziehungen auf das DriveItem anwenden.

HTTP/1.1 200 OK
Content-type: application/json

{
  "id": "0123456789abc",
  "name": "Documents",
  "eTag": "012345819293.1",
  "specialFolder": {
    "name": "documents"
  }
}

Abrufen der untergeordneten Elemente eines speziellen Ordners

Um die untergeordneten Elemente eines speziellen Ordners anzufordern, können Sie die children-Sammlung anfordern oder die Option expand verwenden, um die Sammlung untergeordneter Elemente zu erweitern.

HTTP-Anforderung

GET /me/drive/special/{special-folder-name}/children

HTTP-Antwort

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {"name": "myfile.jpg", "size": 2048 },
    {"name": "Documents", "folder": { "childCount": 4} },
    {"name": "Photos", "folder": { "childCount": 203} },
    {"name": "my sheet(1).xlsx", "size": 197 }
  ]
}

Bemerkungen

Hinweis: DriveItems mit der specialFolder-Facette geben an, dass das Element ein spezieller Ordner ist und der Zugriff über die special-Sammlung erfolgen kann.

Wenn Ihre App über Leseberechtigungen verfügt, schläft die Anforderung zum Abrufen eines speziellen Ordners oder der untergeordneten Elemente eines speziellen Ordners mit dem Fehler 404 Not Found oder 403 Forbidden fehl, wenn der spezielle Ordner nicht bereits vorhanden ist.