L'API Google Drive fornisce la risorsa Revisioni per consentirti di scaricare e pubblicare le revisioni dei file. Per ulteriori dettagli sulla terminologia di revisione, consulta Panoramica di modifiche e revisioni.
Specifica le revisioni da salvare dall'eliminazione automatica
Google Drive elimina automaticamente le revisioni meno recenti 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 definitivamente.
Scaricare una revisione
Puoi utilizzare il valore del campo headRevisionId della risorsa File per scaricare l'ultima revisione.
Questa operazione consente di recuperare la revisione che corrisponde ai metadati del file recuperato in precedenza. Per scaricare i dati di tutte le revisioni precedenti del file che sono ancora archiviati nel cloud, puoi chiamare revisions.list, che recupera tutti i revisioniId.
Per scaricare il contenuto della revisione, devi chiamare
Metodo revisions.get con il parametro alt=media. Le revisioni per Documenti, Fogli e Presentazioni Google non possono essere scaricate.
Le revisioni di Documenti Google, Disegni Google e Presentazioni incrementano automaticamente i numeri delle revisioni. Tuttavia, alcune serie di numeri possono presentare delle lacune se le revisioni vengono eliminate, quindi non fare affidamento su numeri sequenziali quando recuperi le revisioni.
Pubblica una revisione
Per pubblicare una revisione di Documenti, Fogli e Presentazioni Google, devi impostare la proprietà published per quel file nella proprietà Revisioni. Questa proprietà non può essere impostata per le revisioni di Google Sites tramite l'API Drive.
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 Google
File di 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 venga impostata la proprietà publishAuto. Se la proprietà è impostata su true, le revisioni più recenti di un file verranno pubblicate automaticamente, sovrascrivendo quelle precedenti. Questo comportamento è controllato anche dall'opzione "Ripubblica automaticamente in caso di modifiche" nella UI di Drive. Per i file di Google Sites, il valore publishAuto è sempre false.