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 Présentation des modifications et des révisions.
Ce guide explique comment gérer les révisions de fichiers à l'aide de l'API Google Drive.
Spécifier les révisions à exclure de la suppression automatique
Google Drive supprime automatiquement les anciennes révisions qui ne présentent plus d'intérêt pour l'utilisateur.
Une révision de fichier blob peut être définie sur "Conserver indéfiniment", ce qui signifie qu'elle ne peut pas être supprimée automatiquement. Vous pouvez définir jusqu'à 200 révisions sur "Conserver indéfiniment". Elles sont comptabilisées dans votre limite de stockage. La révision principale n'est jamais supprimée automatiquement.
Toute révision de fichier blob, autre que la révision principale, qui n'est pas désignée comme "Conserver indéfiniment" peut être supprimée. Les révisions supprimables sont généralement conservées pendant 30 jours, mais peuvent être supprimées plus tôt si un fichier comporte 100 révisions qui ne sont pas désignées comme "À conserver indéfiniment " et qu'une nouvelle révision est importée.
Vous pouvez définir le champ booléen keepForever de la ressource revisions sur true pour marquer les révisions que vous ne souhaitez pas que Drive supprime. Une fois qu'une révision de fichier blob est définie sur "Conserver indéfiniment", elle ne peut être que téléchargée ou supprimée. Pour en savoir plus, consultez Télécharger une révision ou Supprimer une révision.
Télécharger une révision
Vous ne pouvez télécharger que les révisions de contenu de fichier blob marquées comme "Conserver indéfiniment". Si vous souhaitez télécharger une révision, assurez-vous d'abord de la définir sur "Conserver indéfiniment". Pour en savoir plus, consultez Spécifier les révisions à enregistrer pour éviter la suppression automatique.
Pour télécharger une révision du contenu d'un fichier blob ou exporter une révision du contenu d'un document Google Workspace, consultez Télécharger et exporter des fichiers.
Supprimer une révision
Vous pouvez appeler la méthode revisions.delete pour supprimer définitivement une révision de fichier blob, même lorsqu'elle est marquée comme "Conserver indéfiniment".
Si vous utilisez l'ancienne API Drive v2, utilisez plutôt le champ pinned de la ressource revisions.
Publier une révision
Pour publier une révision 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 Dessin ne permettent pas de publier des révisions spécifiques. Seule la republication automatique de la révision la plus récente est acceptée. Pour publier des présentations Slides 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 réservée aux utilisateurs du domaine. Pour les fichiers Sites, cette propriété indique si une autorisation type=anyone existe. Pour en savoir plus, consultez le champ type de la ressource permissions.
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 la propriété est définie sur true, les révisions plus récentes d'un fichier sont automatiquement publiées, ce qui remplace les précédentes.
Seuls Slides et Drawings sont compatibles avec la republication automatique. Ils nécessitent que la propriété publishAuto soit définie sur true. Pour les fichiers Sites, publishAuto est toujours false.
La publication automatique est également contrôlée par la case à cocher "Republier automatiquement après chaque modification" dans l'interface utilisateur de Docs et Sheets. Pour en savoir plus, consultez Rendre Google Docs, Sheets, Slides et Forms publics.