Speziellen Ordner nach Name abrufenGet a special folder by name

Namespace: Microsoft. GraphNamespace: microsoft.graph

Verwenden Sie spezielle Auflistung, um auf einen speziellen Ordner basierend auf dem Namen zuzugreifen.Use the special collection to access a special folder by name.

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.Special folders provide simple aliases to access well-known folders in OneDrive without the need to look up the folder by path (which would require localization), or reference the folder with an ID. If a special folder is renamed or moved to another location within the drive, this syntax will continue to find that folder.

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.Special folders are automatically created the first time an application attempts to write to one, if it doesn't already exist. If a user deletes one, it is recreated when written to again.

Hinweis: Wenn Sie nur über Leseberechtigungen verfügen und einen speziellen Ordner anfordern, der nicht vorhanden ist, wird ein 403 Forbidden-Fehler angezeigt.Note: If you have read-only permissions and request a special folder that doesn't exist, you'll receive a 403 Forbidden error.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Files.ReadWrite.AppFolder, Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.ReadWrite.AppFolder, Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
AnwendungApplication Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-AnforderungHTTP Request

GET /me/drive/special/{name}

Namen für spezielle OrdnerSpecial folder names

Im Folgenden sind Namen für spezielle Ordner aufgelistet, die in OneDrive und OneDrive for Business zur Verfügung stehen.The follow special folder names are available in OneDrive and OneDrive for Business.

NameName Ordner-IDFolder id BeschreibungDescription
DokumenteDocuments documents Der Ordner „Dokumente“.The Documents folder.
FotosPhotos photos Der Ordner „Fotos“.The Photos folder.
Eigene AufnahmenCamera Roll cameraroll Der Sicherungsordner für Eigene Aufnahmen.The Camera Roll Backup folder.
AnwendungsstammApp Root approot Der persönliche Ordner der Anwendung. In der Regel unter /Apps/{Application Name}The application's personal folder. Usually in /Apps/{Application Name}
MusikMusic music Der Ordner „Musik“.The Music folder.

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt die OData-Abfrageparameter von $expand und $select zur Anpassung der Antwort.This method supports the $expand and $select OData query parameters to customize the response.

AntwortResponse

Die Methode gibt den Antwortcode 200 OK und das aktualisierte driveItem-Objekt im Antworttext zurück.This method returns a 200 OK response code and a driveItem object in the response body.

Sie können diese Methode der Adressierung eines speziellen Ordners mit dem zusätzlichen Aufruf der Eigenschaften oder Beziehungen auf das DriveItem anwenden.You can use this method of addressing a special folder inline with additional calls to properties or relationships on the driveItem.

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 OrdnersGet children of a special folder

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.To request the children of a special folder, you can request the children collection or use the expand option to expand the children collection.

HTTP-AnforderungHTTP request

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

AntwortResponse

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 }
  ]
}

BemerkungenRemarks

Hinweis: DriveItems mit der specialFolder-Facette geben an, dass das Element ein spezieller Ordner ist und der Zugriff über die special-Sammlung erfolgen kann.Note: DriveItems with the specialFolder facet indicate the item is a special folder and can be accessed via the special collection.

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.If your app has read-only permissions, the request to get a special folder or the children of a special folder may fail with a 404 Not Found or a 403 Forbidden error if the special folder does not already exist.