Questa guida spiega come utilizzare la risorsa revisions
per gestire le revisioni dei file, ad esempio per ottenere una revisione di un file e
pubblicare una revisione di Google Workspace. L'API Google Drive ti consente anche di
scaricare le revisioni. Per maggiori dettagli sulla terminologia relativa alle revisioni, consulta Panoramica di modifiche e revisioni.
Per accedere alla cronologia delle revisioni, un utente deve disporre del ruolo role di owner,
organizer, fileOrganizer o writer.
Per specificare i campi da restituire nella risposta, puoi impostare il fields
parametro di sistema
con qualsiasi metodo della risorsa revisions. Se
ometti il parametro, il server restituisce un insieme predefinito di campi. Ad esempio, il metodo revisions.list restituisce solo i campi id, mimeType, kind e modifiedTime. Per restituire campi diversi, vedi Restituire campi specifici.
Specificare le revisioni da salvare dall'eliminazione automatica
Google Drive elimina automaticamente le revisioni precedenti che non sono più di interesse per 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.
Se utilizzi la versione precedente dell'API Drive v2, utilizza il campo pinned della risorsa
revisions anziché
keepForever.
Recuperare una revisione del file
Per ottenere i metadati o i contenuti di una revisione di un file, utilizza il metodo get nella risorsa
revisions con i parametri di percorso fileId e
revisionId. Se non conosci l'ID revisione, puoi elencare
tutte le revisioni di un file utilizzando il metodo list.
Il metodo restituisce i metadati della revisione come istanza di una risorsa revisions.
Per riconoscere il rischio di scaricare malware noti o altri
file abusivi, imposta il
parametro di query acknowledgeAbuse su true. Questo campo è applicabile solo quando
il parametro alt=media è impostato e l'utente è il proprietario del file o
un organizzatore del Drive condiviso in cui si trova il file.
Elencare le revisioni di un file
Per elencare le revisioni di un file, utilizza il metodo list
nella risorsa revisions con il
parametro di percorso fileId. Il metodo restituisce un elenco delle revisioni del file.
Trasmetti i seguenti parametri di query per personalizzare la paginazione o filtrare le revisioni:
pageSize: il numero massimo di revisioni da restituire per pagina.pageToken: un token di pagina ricevuto da una precedente chiamata dell'elenco. Fornisci questo token per recuperare la pagina successiva.
Aggiornare una revisione del file
Per aggiornare una revisione di un file, utilizza il metodo
update sulla risorsa revisions con i parametri di percorso fileId e revisionId.
Il metodo restituisce un'istanza di una risorsa revisions.
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 di un file
Per eliminare definitivamente una revisione di un file, utilizza il
metodo delete sulla risorsa revisions con i parametri
del percorso fileId e revisionId.
Puoi eliminare le revisioni solo per i file blob con contenuti binari in Drive, come immagini, video e PDF. Puoi eliminare una revisione di un file blob quando è contrassegnata come "Conserva per sempre". Le revisioni di altri file, come un documento o un foglio Google, e l'ultima revisione rimanente del file binario non possono essere eliminate.
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.
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.
Slides 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.
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.
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.