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 ressourceRevisions
permet de définir une révision sur "Conserver indéfiniment". De plus, vous pouvez appelerrevisions.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
- Pour déterminer où la modification que vous souhaitez suivre est enregistrée, consultez la section Identifier le journal des modifications à suivre.
- Pour configurer le suivi des modifications pour les utilisateurs et les Drive partagés, consultez Suivre les modifications pour les utilisateurs et les Drive partagés.
- Pour publier, télécharger ou interroger des révisions, consultez Télécharger et publier des révisions de fichier.
- Pour configurer les notifications de modification, consultez la section Notifications push.