L'API Google Drive fournit la 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 liée aux révisions, consultez la présentation des modifications et des révisions.
Spécifier des 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'indicateur booléen 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.
Cette opération extrait la révision correspondant aux métadonnées du fichier 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 obtient tous les ID de révision.
Pour télécharger le contenu de la révision, vous devez appeler
Méthode revisions.get avec le paramètre alt=media. Les révisions pour Google Docs, Sheets et Slides ne peuvent pas être téléchargées.
Les révisions Google Docs, Google Drawings et Slides incrémentent automatiquement les numéros de révision. Cependant, les séries de nombres peuvent comporter des espaces si des révisions sont supprimées, vous ne devez donc pas vous appuyer sur des numéros 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é 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 Google Workspace domaine,
la propriété publishedOutsideDomain indique si la révision est
accessible par tous ou s’il est
limité aux utilisateurs du domaine. Pour Google
Fichiers Sites, cette propriété indique s'il existe une autorisation type=anyone.
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 révisions plus récentes d'un fichier sont automatiquement publiées et remplacent les précédentes. Ce comportement est également contrôlé par la fonctionnalité "Republier automatiquement après chaque modification". dans l'interface utilisateur de Drive. Pour les fichiers Google Sites, publishAuto correspond toujours à false.