Untergeordnete Elemente eines DriveItem auflisten

Eine Auflistung von DriveItems im untergeordneten Verhältnis eines DriveItem zurückgeben.

DriveItems mit einem nicht-NULL-Werte-Ordner oder einer Paket-Facette können ein oder mehrere untergeordnete DriveItems haben.

Voraussetzungen

Einer der folgenden Bereiche ist erforderlich, um diese API auszuführen:

  • Files.Read
  • Files.ReadWrite

HTTP-Anforderung

GET /me/drive/root/children
GET /me/drive/items/{item-id}/children
GET /me/drive/root:/{item-path}:/children
GET /drives/{drive-id}/items/{item-id}/children
GET /groups/{group-id}/drive/root/children
GET /groups/{group-id}/drive/items/{item-id}

Optionale Abfrageparameter

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.

Anforderungsheader

Name Typ Beschreibung
if-none-match String Wenn dieser Anforderungsheader enthalten ist und das angegebene eTag (oder cTag) mit dem aktuellen Tag in der Datei übereinstimmt, wird die Antwort HTTP 304 Not Modified zurückgegeben.

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Beispiel

Anforderung

Es folgt eine Beispiel für eine Anforderung, die DriveItems in den Stammordner des aktuellen Benutzers in OneDrive zurückgibt.zugeben.

GET https://graph.microsoft.com/v1.0/me/drive/root/children

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

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

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

Hinweis: Wenn eine Auflistung die Standardseitengröße (200 Artikel) überschreitet, wird die Eigenschaft @odata.nextLink in der Antwort zurückgegeben, damit angezeigt wird, dass mehr Elemente zur Verfügung, und die Anfrage-URL für die nächste Seite von Elementen zurückzugeben.

Sie können die Seitengröße über Optionale Abfragezeichenfolge-Parameter steuern.