Questa guida spiega come utilizzare la revisions
risorsa per gestire le revisioni dei file, ad esempio recuperare 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 delle revisioni, consulta Modifiche
e revisioni.
Per accedere alla cronologia delle revisioni, un utente deve avere il 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, consulta Restituire campi specifici.
Specificare le revisioni da salvare dall'eliminazione automatica
Google Drive elimina automaticamente le revisioni precedenti che non interessano più l'utente.
Una revisione di un 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 dello spazio di archiviazione. La revisione principale non viene mai eliminata automaticamente.
Qualsiasi revisione di un 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 di un file blob su "Conserva per sempre", può essere solo scaricata o eliminata. Per ulteriori informazioni, consulta
Scaricare una revisione o Eliminare una
revisione.
Se utilizzi la versione precedente dell'API Drive v2, utilizza il pinned campo della
revisions risorsa anziché
keepForever.
Recuperare una revisione di un file
Per recuperare i metadati o i contenuti di una revisione di un file, utilizza il get metodo sulla
revisions risorsa con i fileId e
revisionId parametri di percorso. Se non conosci l'ID della 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
illeciti file, imposta il
acknowledgeAbuse parametro di query su true. Questo campo è applicabile solo quando è impostato il parametro alt=media 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 list
metodo sulla risorsa revisions con il
fileId parametro di percorso. Il metodo restituisce un elenco di revisioni dei file.
Trasmetti i seguenti parametri di query per personalizzare la paginazione delle revisioni o filtrarle:
pageSize: il numero massimo di revisioni da restituire per pagina.pageToken: un token di pagina ricevuto da una chiamata di elenco precedente. Fornisci questo token per recuperare la pagina successiva.
Aggiornare una revisione di un file
Per aggiornare una revisione di un file, utilizza il
update metodo sulla revisions risorsa 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 ulteriori informazioni, consulta Specificare le revisioni da salvare dall'eliminazione automatica.
Per scaricare una revisione dei contenuti di un file blob o per esportare una revisione dei contenuti di un documento di Google Workspace consulta Scaricare ed esportare file.
Eliminare una revisione di un file
Per eliminare definitivamente una revisione di un file, utilizza il
delete metodo sulla risorsa revisions con i parametri di percorso fileId e revisionId.
Puoi eliminare solo le revisioni dei 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 Documenti o Fogli 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 published proprietà per quel file nella
revisions risorsa. 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.
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.
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
ulteriori informazioni, consulta il
type campo nella
permissions risorsa.
La pubblicazione automatica è controllata anche dalla casella di controllo "Ripubblica automaticamente quando vengono apportate modifiche" nell'interfaccia utente di Documenti e Fogli. Per ulteriori informazioni, consulta Rendere pubblici file di Documenti, Fogli, Presentazioni e Moduli Google.