L'API Google Drive fournit une ressource Revisions (Révisions) qui vous permet de télécharger et de publier des révisions de fichiers. Pour en savoir plus sur la terminologie associée aux révisions, consultez Présentation des modifications et des révisions.
Spécifier les révisions à enregistrer à partir de la suppression automatique
Google Drive supprime automatiquement les anciennes révisions qui ne présentent plus d'intérêt pour l'utilisateur. Pour éviter cela, vous pouvez définir l'option booléenne keepRevisionForever
sur true
pour marquer les révisions que vous ne souhaitez pas que Drive supprime définitivement.
Télécharger une révision
Vous pouvez utiliser la valeur du champ headRevisionId
de la ressource Files pour télécharger la dernière révision.
Cela permet d'extraire la révision correspondant aux métadonnées du fichier que vous avez précédemment récupéré. Pour télécharger les données de toutes les révisions précédentes du fichier qui sont toujours stockées dans le cloud, vous pouvez appeler revisions.list
, qui récupère tous les ID de révision.
Pour télécharger le contenu de la révision, vous devez appeler la méthode revisions.get
avec le paramètre alt=media
. Impossible de télécharger des révisions Google Docs, Sheets et Slides.
Les révisions de Google Docs, Google Drawings et Slides sont incrémentées automatiquement. Cependant, une série de chiffres peut contenir des blancs si des révisions sont supprimées. Vous ne devez donc pas utiliser des nombres séquentiels lorsque vous récupérez des révisions.
Publier une révision
Pour publier une révision Google Docs, Sheets ou Slides, définissez la propriété published
de ce fichier dans la propriété Revisions (Révisions). Cette propriété ne peut pas être définie pour les révisions de Google Sites via l'API Drive.
Si le fichier est créé dans un domaine Google Workspace , la propriété publishedOutsideDomain
indique si la révision est accessible par tout le monde ou si elle est limitée aux utilisateurs du domaine. Pour les fichiers Google Sites, cette propriété indique si une autorisation type=anyone
existe.
Les révisions publiées ne reflètent pas les modifications apportées à un fichier, sauf si la propriété publishAuto
est définie. Si cette propriété est définie sur "true", les nouvelles révisions d'un fichier sont publiées automatiquement et remplacent les précédentes. Ce comportement est également contrôlé par la case "Republier automatiquement après chaque modification" dans l'interface utilisateur Drive. Pour les fichiers Google Sites, publishAuto
est toujours false
.