Method: revisions.list

Liste les révisions d'un fichier.

Important : La liste des révisions renvoyée par cette méthode peut être incomplète pour les fichiers dont l'historique des révisions est volumineux, y compris les documents, feuilles de calcul et présentations Google fréquemment modifiés. Les anciennes révisions peuvent être omises de la réponse, ce qui signifie que la première révision renvoyée peut ne pas être la plus ancienne. L'historique des révisions visible dans l'interface utilisateur de l'éditeur Workspace peut être plus complet que la liste renvoyée par l'API.

Requête HTTP

GET https://www.googleapis.com/drive/v2/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
maxResults

integer

Nombre maximal de révisions à renvoyer.
pageToken

string

Jeton de page pour les révisions. Pour obtenir la page de résultats suivante, définissez ce paramètre 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 
{
  "items": [
    {
      object (Revision)
    }
  ],
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string
}
Champs
items[]

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. Ce champ est absent 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.
kind

string

Cette valeur est toujours drive#revisionList.
etag

string

ETag de la liste.

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