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 avec des modifications spécifiques.

Les termes suivants sont pertinents pour 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 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, tel que Google Docs, Sheets ou Slides. Pour les membres d'un Drive partagé, le journal des modifications utilisateur inclut également des entrées sur l'appartenance au Drive partagé, les niveaux d'accès des utilisateurs aux éléments de ce Drive partagé et les modifications de son nom.
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é. Une modification apportée à un élément dans un Drive partagé apparaît à la fois dans le journal des modifications de l'utilisateur et dans celui du Drive partagé.
Entrée de journal des modifications
Enregistrement d'une modification apportée au contenu 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, le code temporel et un ID. Il ne peut y avoir qu'une seule entrée par fichier ou Drive partagé dans le journal des modifications à la fois. Chaque fois que ce fichier ou ce Drive partagé change, 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" dans l'API Drive.
Révision principale
Version la plus récente d'un fichier.
Révision de blob

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

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

Toute révision, à l'exception de la révision principale, qui n'est pas désignée comme étant "Conserver indéfiniment" peut être supprimée définitivement. Les révisions pouvant être supprimées sont généralement conservées pendant 30 jours, mais elles peuvent être supprimées plus tôt si un fichier comporte 100 révisions qui ne sont pas désignées comme "Conserver pour toujours" 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 pour toujours". Vous pouvez également appeler revisions.delete pour supprimer une révision même si elle est marquée comme "Conserver pour toujours".

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 change, Drive crée une nouvelle entrée dans l'historique des révisions pour ce fichier. Toutefois, ces révisions de fichiers de l'éditeur peuvent être fusionnées. La réponse de l'API peut donc 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