L'API Google Drive fornisce la risorsa revisions
in modo da poter scaricare e pubblicare le revisioni dei file. Per maggiori dettagli sulla terminologia
delle revisioni, consulta la Panoramica
di modifiche e revisioni.
Questa guida spiega come gestire le revisioni dei file utilizzando l'API Google Drive.
Specificare le revisioni da salvare dall'eliminazione automatica
Google Drive elimina automaticamente le revisioni precedenti che non interessano più l'utente.
Una revisione del file blob può essere impostata su "Conserva per sempre", il che significa che la revisione non può essere eliminata automaticamente. È possibile impostare fino a 200 revisioni su "Conserva per sempre" e queste vengono conteggiate ai fini del calcolo del limite di spazio di archiviazione. La revisione principale non viene mai eliminata automaticamente.
Qualsiasi revisione di file blob, diversa dalla revisione principale, che non è 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 non designate come "Conserva per sempre" e viene caricata una nuova revisione.
Puoi impostare il campo booleano keepForever della risorsa revisions su true per contrassegnare le revisioni che non vuoi che Drive elimini. Una volta impostata una revisione del file blob su
"Conserva per sempre", può essere solo scaricata o eliminata. Per saperne di più, vedi
Scaricare una revisione o Eliminare una
revisione.
Scaricare una revisione
Puoi scaricare solo le revisioni dei contenuti dei file blob contrassegnate come "Conserva per sempre". Se vuoi scaricare una revisione, assicurati di impostarla prima su "Conserva per sempre". Per saperne di più, consulta Specificare le revisioni da salvare dalla cancellazione automatica.
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.
Eliminare una revisione
Puoi chiamare il metodo revisions.delete per eliminare definitivamente una revisione di un file blob, anche se è contrassegnata come "Conserva per sempre".
Se utilizzi la versione precedente dell'API Drive v2, utilizza il campo pinned della risorsa
revisions.
Pubblicare una revisione
Per pubblicare una revisione di Documenti, Fogli e Presentazioni Google, imposta
la proprietà published per il file nella
risorsa revisions. Questa proprietà non può essere impostata
per le revisioni di Google Sites utilizzando l'API Drive.
Presentazioni Google e Google Disegni non supportano la pubblicazione di revisioni specifiche. È supportata solo la ripubblicazione automatica della revisione più recente. Per pubblicare Presentazioni e Disegni, imposta anche
publishAuto su true.
Se il file viene creato in un dominio Google Workspace, la proprietà
publishedOutsideDomain indica se la revisione è accessibile
a chiunque o se è limitata agli utenti del dominio. Per i file di Sites, questa proprietà indica se esiste un'autorizzazione type=anyone. Per
maggiori informazioni, consulta il campo
type nella risorsa
permissions.
Le revisioni pubblicate non riflettono le modifiche apportate a un file a meno che non sia impostata la proprietà
publishAuto. Se la proprietà è impostata su true, le revisioni più recenti
di un file vengono pubblicate automaticamente, sovrascrivendo quelle precedenti.
Presentazioni e Disegni supportano solo la ripubblicazione automatica e richiedono che la proprietà publishAuto sia impostata su true. Per i file di
Sites, publishAuto è sempre false.
La pubblicazione automatica è controllata anche dalla casella di controllo "Ripubblica automaticamente in caso di modifiche" nell'interfaccia utente di Documenti e Fogli. Per saperne di più, vedi Rendere pubblici file di Documenti, Fogli, Presentazioni e Moduli Google.