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

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

Remarque :L'accès à l'historique des révisions est limité en fonction du rôle. Consultez le capabilities.canReadRevisions du fichier avant la une tentative d'accès.

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.

Remarque :Si vous utilisez l'ancienne version 2 de l'API Drive, vous devez envoyer un GET à sa propriété downloadUrl. Google Drive génère cet élément à court terme lorsque vous demandez la révision. Ne vous fiez pas à elle pour une utilisation ultérieure. Vous pouvez également exporter la révision dans l'un des formats pris en charge en cochant la case exportLinks.

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.