L'API Google Drive fournit la ressource Révisions qui vous permet de télécharger et de publier des révisions de fichiers. Pour plus d'informations sur la terminologie des révisions, consultez la page 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'indicateur booléen keepRevisionForever sur true pour indiquer 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 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. Les révisions de 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 le numéro de révision. Cependant, les séries de numéros peuvent présenter des blancs si des révisions sont supprimées. Par conséquent, ne vous fiez pas à 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 et Slides, vous devez définir la propriété published de ce fichier dans la propriété Révisions. Cette propriété ne peut pas être configurée pour les révisions 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 à tous ou si elle est limitée aux utilisateurs du domaine. Pour les fichiers Google 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 les plus récentes d'un fichier sont automatiquement publiées et remplacent les précédentes. Ce comportement est également contrôlé par la case à cocher "Republier automatiquement après chaque modification" dans l'interface utilisateur de Drive. Pour les fichiers Google Sites, publishAuto est toujours false.