Method: children.list

Répertorie 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 touche est triée par ordre croissant, mais vous pouvez inverser l'ordre avec le modificateur desc. Exemple d'utilisation: ?orderBy=folder,modifiedDate desc,title. Veuillez noter qu'une limite s'applique actuellement aux utilisateurs disposant d'environ un million de fichiers pour 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 suivante d'enfants. Cette valeur est absente si vous avez atteint la fin de la liste des enfants. 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

Cette valeur est toujours 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 doit ê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 soumis à des restrictions et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide d'autorisation.