Répertorier les enfants d’un objet DriveItemList children of a driveItem

Renvoyez une collection d’objets DriveItem dans la relation enfants d’un objet DriveItem.Return a collection of DriveItems in the children relationship of a DriveItem.

Les objets DriveItem avec une facette non Null folder ou package peuvent avoir un ou plusieurs objets DriveItem enfants.DriveItems with a non-null folder or package facet can have one or more child DriveItems.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)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
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
ApplicationApplication Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Requête HTTPHTTP request

GET /drives/{drive-id}/items/{item-id}/children
GET /groups/{group-id}/drive/items/{item-id}/children
GET /me/drive/items/{item-id}/children
GET /sites/{site-id}/drive/items/{item-id}/children
GET /users/{user-id}/drive/items/{item-id}/children

Paramètres facultatifs de la requêteOptional query parameters

Cette méthode prend en charge les paramètres de requête OData $expand, $select, $skipToken, $top et $orderby pour vous aider à personnaliser la réponse.This method supports the $expand, $select, $skipToken, $top and $orderby OData query parameters to customize the response.

En-têtes de demande facultatifsOptional request headers

NomName ValeurValue DescriptionDescription
if-none-matchif-none-match etagetag Si cet en-tête de demande est inclus et que l’eTag (ou cTag) fourni correspond à l’identité actuelle sur le fichier, une réponse HTTP 304 Not Modified est renvoyée.If this request header is included and the eTag (or cTag) provided matches the current tag on the file, an HTTP 304 Not Modified response is returned.

ExemplesExamples

Répertorier les enfants dans la racine du lecteur de l’utilisateur actuelList children in the root of the current user's drive

Pour récupérer des fichiers dans la racine du lecteur, utilisez la relation root sur le lecteur, puis accédez à la relation enfant.To retrieve files in the root of the drive, use the root relationship on the drive, then access the children relationship.

GET /me/drive/root/children

Répertorier les enfants d’une ressources DriveItem avec un ID connuList children of a DriveItem with a known ID

Pour récupérer des fichiers dans la racine du lecteur, utilisez la relation root sur le lecteur, puis accédez à la relation enfant.To retrieve files in the root of the drive, use the root relationship on the drive, then access the children relationship.

GET /drives/{drive-id}/items/{item-id}/children

Répertorier les enfants d’une ressource DriveItem avec un chemin d’accès connuList children of a DriveItem with a known path

GET /drives/{drive-id}/root:/{path-relative-to-root}:/children

RéponseResponse

Si elle réussit, cette méthode renvoie la liste des éléments dans la collection d’enfants de l’élément cible.If successful, this method returns the list of items in the children collection of the target item. La collection d’enfants est composée des ressources driveItem.The children collection will be composed of driveItem resources.

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://..."
}

Remarque : si une collection dépasse le format de page par défaut (200 éléments), la propriété **@odata.nextLink** est renvoyée dans la réponse pour indiquer que d’autres éléments sont disponibles et fournir l’URL de la demande pour la page d’éléments suivante.Note: If a collection exceeds the default page size (200 items), the **@odata.nextLink** property is returned in the response to indicate more items are available and provide the request URL for the next page of items.

Vous pouvez contrôler le format de page par le biais des paramètres de chaîne de requête facultatifsYou can control the page size through optional query string parameters

Réponses d’erreurError responses

Pour plus d’informations sur la façon dont les erreurs sont renvoyées, voir Réponses d’erreur.See Error Responses for more info about how errors are returned.