Présentation des modifications et des révisions

Google Drive conserve un historique automatique des modifications, 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 avec des modifications spécifiques.

Les termes suivants s'appliquent aux 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 à chaque fichier modifiable de son dossier Mon Drive (Google Docs, Sheets ou Slides, par exemple). Pour les membres d'un Drive partagé, le journal des modifications des utilisateurs comprend également des entrées sur l'appartenance aux Drive partagés, les niveaux d'accès des utilisateurs aux éléments de ce Drive et les changements de nom de ce Drive.
Journal des modifications des Drive partagés
Enregistrement de toutes les modifications apportées à un Drive partagé, telles que les ajouts ou suppressions d'utilisateurs, et toutes les modifications apportées aux éléments du Drive partagé. Les modifications apportées à un élément d'un Drive partagé apparaissent à 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'auteur de la modification, l'horodatage et un ID. Il ne peut y avoir qu'une seule entrée par fichier ou Drive partagé dans le journal des modifications. Chaque fois que ce fichier ou ce Drive partagé est modifié, un 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" dans 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 (image, vidéo ou PDF, par exemple). 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 d'objets 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 de l'élément principal n'est jamais supprimée 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 pouvant ê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 contient 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 lorsqu'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. Une modification apportée à un fichier Docs, Sheets ou Slides reçoit une nouvelle révision. Chaque fois que le contenu est modifié, Drive crée une entrée d'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