Télécharger et publier des révisions de fichiers

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 en savoir plus sur la terminologie liée aux révisions, consultez la section 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 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 de récupérer 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 la méthode revisions.get avec le paramètre alt=media. Il n'est pas possible de télécharger les révisions de Google Docs, Sheets et Slides.

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 pour récupérer des révisions.

Publier une révision

Pour publier une révision Google Docs, Sheets ou 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 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 à 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 au 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 écrasent les précédentes. Vous pouvez aussi cocher la case "Republier automatiquement après chaque modification" dans l'interface utilisateur de Drive. Pour les fichiers Google Sites, publishAuto est toujours false.