L'API Google Drive fornisce la risorsa Revisioni per consentirti di scaricare e pubblicare le revisioni dei file. Per maggiori dettagli sulla terminologia delle revisioni, vedi Panoramica delle modifiche e delle 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 dalla risorsa File per scaricare la revisione più recente.
Questa azione recupera la revisione corrispondente ai metadati del file recuperato in precedenza. Per scaricare i dati di tutte le revisioni precedenti del file ancora archiviate nel cloud, puoi chiamare revisions.list, che recupera tutti gli ID revisione.
Per scaricare il contenuto della revisione, devi chiamare il metodo revisions.get con il parametro alt=media. Le revisioni per Documenti, Fogli e Presentazioni Google non possono essere scaricate.
Le revisioni di Documenti, Disegni Google e Presentazioni incrementano automaticamente i numeri delle revisioni. Tuttavia, le serie di numeri possono presentare intervalli vuoti se le revisioni vengono eliminate, quindi non devi fare affidamento sui numeri in sequenza quando recuperi le revisioni.
Pubblicare una revisione
Per pubblicare una revisione di Documenti, Fogli e Presentazioni Google, imposta 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 Google Workspace dominio,
la proprietà publishedOutsideDomain indica se la revisione è
accessibile da chiunque o se è limitata agli utenti del dominio. Per i file di Google 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 verranno pubblicate automaticamente, sovrascrivendo quelle precedenti. Questo comportamento è controllato anche dalla casella di controllo "Ripubblica automaticamente in caso di modifiche" nell'interfaccia utente di Drive. Per i file di Google Sites, publishAuto è sempre false.