Method: children.list

Liste les enfants d'un dossier.

Requête HTTP

GET https://www.googleapis.com/drive/v2/files/{folderId}/children

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
folderId

string

ID du dossier.

Paramètres de requête

Paramètres
maxResults

integer

Nombre maximal d'enfants à renvoyer.

orderBy

string

Liste de clés de tri séparées par une virgule. Les clés valides sont createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred et title. Par défaut, chaque clé est triée dans l'ordre croissant, mais vous pouvez l'inverser avec le modificateur desc. Exemple d'utilisation: ?orderBy=folder,modifyDate desc,title. Veuillez noter qu'il existe actuellement une limite pour les utilisateurs disposant d'environ un million de fichiers dans lesquels l'ordre de tri demandé est ignoré.

pageToken

string

Jeton de page pour les enfants.

q

string

Chaîne de requête pour la recherche d'enfants.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Liste des enfants d'un fichier.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (ChildReference)
    }
  ]
}
Champs
nextPageToken

string

Jeton de page pour la page enfant suivante. Ce champ est absent si la fin de la liste des enfants est atteinte. Si le jeton est refusé pour une raison quelconque, il doit être supprimé et la pagination doit être redémarrée à partir de la première page de résultats.

kind

string

Il s'agit toujours de drive#childList.

etag

string

ETag de la liste.

items[]

object (ChildReference)

Liste des enfants. Si nextPageToken est renseigné, cette liste peut être incomplète et une page de résultats supplémentaire devra être extraite.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

Certains champs d'application sont restreints et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le Guide relatif aux autorisations.