Method: revisions.list

Liste les révisions d'un fichier. Pour en savoir plus, consultez Gérer les révisions de fichiers.

Requête HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/revisions

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
fileId

string

ID du fichier.

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal de révisions à renvoyer par page.
pageToken

string

Jeton permettant de poursuivre une requête de liste précédente sur la page suivante. Cette valeur doit être définie sur la valeur de "nextPageToken" de la réponse précédente.

Corps de la requête

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

Corps de la réponse

Liste des révisions 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 
{
  "revisions": [
    {
      object (Revision)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
Champs
revisions[]

object (Revision)

Liste des révisions. Si nextPageToken est renseigné, il est possible que cette liste soit incomplète et qu'une page de résultats supplémentaire doive être récupérée.
nextPageToken

string

Jeton de page pour la page suivante des révisions. Cette valeur est absente si la fin de la liste des révisions a été 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. Le jeton de page est généralement valide pendant plusieurs heures. Toutefois, si de nouveaux éléments sont ajoutés ou supprimés, vos résultats attendus peuvent être différents.
kind

string

Identifie le type de ressource. Valeur : chaîne fixe "drive#revisionList".

Champs d'application des autorisations

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

  • 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 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.