Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Google Drive mantiene una cronologia automatica delle modifiche, che può aiutare
gli utenti a monitorare le modifiche ai file e le revisioni dei contenuti. Nella cronologia delle revisioni, gli utenti
possono vedere quali modifiche sono state apportate e possono ripristinare una versione specifica di un file
con modifiche specifiche.
I seguenti termini sono pertinenti alle risorse relative a modifiche e revisioni dell'API Google Drive:
Elenco di controllo dell'accesso (ACL)
L'elenco di tutte le risorse di autorizzazione associate a un file, una cartella o un Drive condiviso.
Modifica
Modifica apportata ai contenuti o ai metadati di un file o di un Drive condiviso.
Log delle modifiche utente
Un record di tutte le modifiche apportate da un utente a ogni file modificabile in My
Drive, ad esempio un documento, un foglio o una
presentazione Google. Per i membri di un Drive condiviso, il log delle modifiche utente
include anche voci relative all'appartenenza al Drive condiviso, ai livelli di accesso degli utenti
agli elementi del Drive condiviso e alle modifiche del nome del Drive condiviso.
Log delle modifiche del Drive condiviso
Un registro di tutte le modifiche apportate a un Drive condiviso, ad esempio aggiunte o rimozioni di
utenti e tutte le modifiche apportate agli elementi del Drive condiviso. Una modifica a un elemento
all'interno di un Drive condiviso viene visualizzata sia nel log delle modifiche dell'utente sia nel log delle modifiche del Drive condiviso.
Voce del log delle modifiche
Un record di una modifica apportata ai contenuti o ai metadati di un file o di un Drive condiviso. Una voce del log delle modifiche indica l'utente che ha apportato la modifica, il
timestamp e un ID. Nel log delle modifiche può essere presente una sola voce per file o Drive condiviso alla volta. Ogni volta che il file o il Drive condiviso cambia, viene creato un nuovo ID per la voce, che sostituisce la precedente.
Revisione
Una versione del file che rappresenta una modifica ai contenuti del file (non
ai metadati). È possibile accedere a ogni revisione utilizzando la risorsa revisions all'interno dell'API Drive.
Revisione principale
La versione più recente di un file. È possibile accedere a headRevisionId utilizzando
la risorsa files all'interno
dell'API Drive. headRevisionId è disponibile solo per i file blob
in Drive.
Revisione del blob
Una versione di un file binario non modificabile, ad esempio un'immagine, un video o un PDF. Se
la revisione del blob è l'unica revisione del file binario, non può essere
eliminata. Un nuovo blob può essere caricato come nuova revisione, che diventa la
nuova revisione principale del file.
Qualsiasi revisione di file blob, diversa dalla revisione principale, che non sia designata
come "Conserva per sempre" è eliminabile. Le revisioni eliminabili vengono in genere conservate
per 30 giorni, ma possono essere eliminate prima se un file ha 100 revisioni che
non sono designate come "Conserva per sempre" e viene caricata una nuova revisione.
Un record di tutte le revisioni di un file in ordine cronologico. Una modifica a un file
Documenti, Fogli o Presentazioni
genera una nuova revisione. Ogni volta che i contenuti cambiano, Drive
crea una nuova voce della cronologia delle revisioni per quel file. Tuttavia, queste revisioni dei file
dell'editor potrebbero essere unite, quindi la risposta dell'API potrebbe non mostrare
tutte le modifiche a un file.
Per scaricare una revisione dei contenuti di un file blob o per esportare una revisione dei contenuti di un documento Google Workspace, vedi Scaricare ed esportare file.
[null,null,["Ultimo aggiornamento 2025-08-21 UTC."],[],[],null,["# Changes and revisions overview\n\nGoogle Drive maintains an automatic history of modifications, which can help\nusers track file changes and content revisions. In the revision history, users\ncan see what edits have been made and can revert to a specific version of a file\nwith specific edits.\n\nThe following terms are relevant to the changes and revisions resources of the\nGoogle Drive API:\n\n*Access Control List (ACL)*\n: The list of all permission resources associated with a file, folder, or shared\n drive.\n\n*Change*\n: An alteration made to a file's content or metadata of a file or shared drive.\n\n*User change log*\n\n: A record of all changes that a user made to every editable file in their My\n Drive, such as a Google Docs, Sheets, or a\n Slides. For members of a shared drive, the user change log\n also includes entries about shared drive membership, user access levels to\n items in that shared drive, and shared drive name changes.\n\n | **Note:** Even if several users can access the same file, not all changes to that file are reflected in every users' change log. For example, when a user opens the file for the first time, or marks the file as Starred, those changes only appear in that users' change log. As another example, when a file's ACL is changed, it's only reflected in the change log of the following users: The file's owner, any service accounts on the ACL, and any users directly impacted by the ACL change.\n\n*Shared drive change log*\n\n: A record of all changes to a shared drive, such as additions or removals of\n users, and all changes to items on that shared drive. A change to an item\n within a shared drive appears in both the *user change log* and shared drive\n change log.\n\n*Change log entry*\n\n: A record of a change made to a file's content or metadata of a file or shared\n drive. A change log entry indicates the user who made the change, the\n timestamp, and an ID. There can only be one entry per file or shared drive\n in the change log at a time. Each time that file or shared drive changes, a\n new ID is created for that entry, and it replaces the previous entry.\n\n*Revision*\n\n: A version of the file representing a change to the file's contents (not\n metadata). Each revision can be accessed using the [`revisions`](/workspace/drive/api/reference/rest/v3/revisions) resource within the Drive API.\n\n*Head revision*\n\n: The most current version of a file. The `headRevisionId` can be accessed using\n the [`files`](/workspace/drive/api/reference/rest/v3/files) resource within the\n Drive API. The `headRevisionId` is only available for blob files\n in Drive.\n\n*Blob revision*\n\n: A version of an unmodifiable binary file, such as an image, video, or PDF. If\n the blob revision is the only revision of the binary file, it cannot be\n deleted. A new blob can be uploaded as a new *revision* , which becomes the\n new *head revision* of that file.\n\n Any blob file revision, other than the head revision, that's not designated\n as \"Keep Forever\" is purgeable. Purgeable revisions are typically preserved\n for 30 days, but can be purged earlier if a file has 100 revisions that\n aren't designated as \"Keep Forever\" and a new revision is uploaded.\n\n For more information on setting blob revisions as \"Keep Forever\", see\n [Specify revisions to save from auto\n delete](/workspace/drive/api/guides/manage-revisions#specify-revisions).\n\n*Revision history*\n\n: A record of all revisions of a file in chronological order. A change to a\n Docs, Sheets, or Slides file\n gets a new revision. Each time the content changes, Drive\n creates a new revision history entry for that file. However, these editor\n file revisions may be merged together, so the API response might not show\n all changes to a file.\n\nRelated topics\n--------------\n\n- To identify where the change you want to track is recorded, see [Identify\n which change log to track](/workspace/drive/api/guides/about-changelogs).\n- To set up change tracking for users and shared drives, see [Track changes\n for users and shared drives](/workspace/drive/api/guides/about-changes).\n- To download a blob file content revision or to export a Google Workspace document content revision, see [Download and export\n files](/workspace/drive/api/guides/manage-downloads).\n- To publish a revision, see [Manage file\n revisions](/workspace/drive/api/guides/manage-revisions).\n- To set up change notifications, see [Notifications for resource changes](/workspace/drive/api/guides/push)."]]
