Présentation des modifications et des révisions

Google Drive conserve un historique automatique des modifications, ce qui peut aider les utilisateurs à suivre les modifications de fichiers et les révisions de contenu. Dans l'historique des révisions, les utilisateurs peuvent voir les modifications apportées et rétablir une version spécifique d'un fichier en y apportant des modifications spécifiques.

Les termes suivants concernent les ressources de modifications et de révisions de l'API Google Drive:

Liste de contrôle d'accès (LCA)
Liste de toutes les ressources d'autorisation associées à un fichier, un dossier ou un Drive partagé.
Modifier
Modification apportée au contenu d'un fichier ou aux métadonnées d'un fichier ou d'un Drive partagé.
Journal des modifications des utilisateurs
Enregistrement de toutes les modifications apportées par un utilisateur à tous les fichiers modifiables de son dossier Mon Drive (Google Docs, Sheets ou Slides, par exemple). Pour les membres d'un Drive partagé, ce journal inclut également des entrées sur l'appartenance à un Drive partagé, les niveaux d'accès des utilisateurs aux éléments de ce Drive et les modifications du nom du Drive partagé.
Journal des modifications des Drive partagés
Enregistrement de toutes les modifications apportées à un Drive partagé, telles que les ajouts ou les suppressions d'utilisateurs, et toutes les modifications apportées aux éléments de ce Drive partagé. Toute modification apportée à un élément d'un Drive partagé apparaît à la fois dans le journal des modifications de l'utilisateur et dans le journal des modifications du Drive partagé.
Entrée du journal des modifications
Enregistrement d'une modification apportée au contenu d'un fichier ou aux métadonnées d'un fichier ou d'un Drive partagé. Une entrée du journal des modifications indique l'utilisateur qui a effectué la modification, l'horodatage et un ID. Il ne peut y avoir qu'une entrée à la fois par fichier ou Drive partagé dans le journal des modifications. Chaque fois que ce fichier ou ce Drive partagé est modifié, un nouvel ID est créé pour cette entrée et remplace l'entrée précédente.
Révision
Version du fichier représentant une modification du contenu du fichier (et non des métadonnées). Chaque révision est accessible à l'aide de la ressource "Révision" de l'API Drive.
Révision principale
Version la plus récente d'un fichier.
Révision des blobs

Version d'un fichier binaire non modifiable, telle qu'une image, une vidéo ou un PDF. Si la révision du blob est la seule révision du fichier binaire, elle ne peut pas être supprimée. Un nouvel objet blob peut être importé en tant que nouvelle révision, qui devient la nouvelle révision principale de ce fichier.

Les révisions de Blob peuvent être définies sur "Conserver indéfiniment", ce qui signifie qu'elles ne peuvent pas être automatiquement supprimées définitivement. Vous pouvez définir jusqu'à 200 révisions sur "Conserver indéfiniment". La révision "head" n'est jamais supprimée automatiquement et définitivement.

Toute révision, à l'exception de la révision principale, qui n'est pas désignée comme "Conserver indéfiniment" peut être supprimée définitivement. Les révisions qui peuvent être supprimées définitivement sont généralement conservées pendant 30 jours, mais peuvent être supprimées définitivement 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.

Le champ keepForever de la ressource Revisions permet de définir une révision sur "Conserver indéfiniment". De plus, vous pouvez appeler revisions.delete pour supprimer une révision, même si elle est marquée comme "Conserver indéfiniment".

Historique des révisions

Enregistrement de toutes les révisions d'un fichier dans l'ordre chronologique. Toute modification apportée à un fichier Docs, Sheets ou Slides fait l'objet d'une nouvelle révision. Chaque fois que le contenu est modifié, Drive crée une entrée dans l'historique des révisions pour ce fichier. Toutefois, ces révisions du fichier d'éditeur peuvent être fusionnées. Par conséquent, la réponse de l'API peut ne pas afficher toutes les modifications apportées à un fichier.

Regardez cette vidéo pour découvrir comment gérer les révisions avec l'API Google Drive:

Étapes suivantes