Gestire le revisioni dei file

L'API Google Drive fornisce la risorsa revisions per consentirti di scaricare e pubblicare le revisioni dei file. Per ulteriori dettagli sulla terminologia delle revisioni, consulta la Panoramica di modifiche e revisioni.

Specificare le revisioni da salvare dall'eliminazione automatica

Google Drive elimina automaticamente le revisioni precedenti che non sono più di interesse per l'utente. Per evitare che ciò accada, puoi impostare il flag booleano keepRevisionForever su true per contrassegnare le revisioni che non vuoi che Drive elimini.

Scaricare una revisione

Per scaricare l'ultima revisione, utilizza il metodo files.download. Per ulteriori informazioni, consulta Gestire le operazioni di lunga durata.

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 Disegno Google 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 Sites, questa proprietà indica se esiste un'autorizzazione type=anyone.

Le revisioni pubblicate non riflettono le modifiche apportate a un file, a meno che non sia impostata la proprietà publishAuto. Se questa proprietà è impostata su true, le revisioni più recenti di un file vengono pubblicate automaticamente, sovrascrivendo quelle precedenti. Questo comportamento è controllato anche dalla casella di controllo "Ripubblica automaticamente in caso di modifiche" nell'interfaccia utente di Drive. Fogli e Drawings supportano solo la ripubblicazione automatica e richiedono che la proprietà publishAuto sia impostata su true. Per i file di Sites, publishAuto è sempre false.