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 touche effectue un tri croissant, mais peut être inversé avec le modificateur desc. Exemple d'utilisation: ?orderBy=folder,modifiedDate desc,title. Notez que l'ordre de tri demandé n'est pas pris en compte pour les utilisateurs disposant d'environ un million de fichiers.

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 d'enfants suivante. Ce champ est absent si la fin de la liste d'enfants est atteinte. Si le jeton est refusé pour une raison quelconque, il doit être supprimé, et la pagination doit être relancé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 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.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 limités 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.