L'API Google Drive fournit la ressource revisions pour vous permettre de télécharger et de publier des révisions de fichiers. Pour en savoir plus sur la terminologie des révisions, consultez la section Présentation des modifications et des révisions.
Spécifier les révisions à conserver pour éviter leur suppression automatique
Google Drive supprime automatiquement les anciennes versions qui ne sont 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 purge.
Télécharger une révision
Pour télécharger la dernière révision, utilisez la méthode files.download. Pour en savoir plus, consultez la section Gérer les opérations de longue durée.
Publier une révision
Pour publier une version de Google Docs, Google Sheets ou Google Slides, définissez la propriété published pour ce fichier dans la ressource revisions. Cette propriété ne peut pas être définie pour les révisions Google Sites à l'aide de l'API Drive.
Google Slides et Google Drawings ne permettent pas de publier des révisions spécifiques. Seule la republication automatique de la dernière révision est prise en charge. Pour publier des présentations et des dessins, définissez également publishAuto sur true.
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 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 versions plus récentes d'un fichier sont publiées automatiquement et remplacent les versions 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. Sheets et Drawings ne prennent en charge que la republication automatique et nécessitent que la propriété publishAuto soit définie sur true. Pour les fichiers Sites, publishAuto est toujours false.