Über die Google Drive API können Sie Dateiüberarbeitungen herunterladen und veröffentlichen. Weitere Informationen zur Versionsterminologie finden Sie unter Übersicht über Änderungen und Überarbeitungen.
Überarbeitungen angeben, die beim automatischen Löschen gespeichert werden sollen
Ältere Versionen, die für den Nutzer nicht mehr relevant sind, werden von Google Drive automatisch gelöscht. Um dies zu verhindern, können Sie das boolesche Flag keepRevisionForever
auf true
setzen, um Überarbeitungen zu markieren, die nicht dauerhaft aus Drive gelöscht werden sollen.
Überarbeitung herunterladen
Sie können den Wert des Felds headRevisionId
aus der Ressource Dateien verwenden, um die neueste Überarbeitung herunterzuladen.
Dadurch wird die Überarbeitung abgerufen, die den Metadaten der zuvor abgerufenen Datei entspricht. Wenn Sie die Daten für alle vorherigen Versionen der Datei herunterladen möchten, die noch in der Cloud gespeichert sind, können Sie revisions.list
aufrufen. Dadurch werden alle versionsIds abgerufen.
Zum Herunterladen des Überarbeitungsinhalts müssen Sie die Methode revisions.get
mit dem Parameter alt=media
aufrufen. Überarbeitungen für Google Docs, Google Tabellen und Google Präsentationen können nicht heruntergeladen werden.
Bei Überarbeitungen in Google Docs, Google Zeichnungen und Google Präsentationen wird die Überarbeitungsnummer automatisch erhöht. Da Zahlenreihen jedoch Lücken aufweisen können, wenn Überarbeitungen gelöscht werden, sollten Sie sich beim Abrufen von Überarbeitungen nicht auf fortlaufende Nummern verlassen.
Überarbeitung veröffentlichen
Wenn Sie eine Überarbeitung in Google Docs, Google Tabellen oder Google Präsentationen veröffentlichen möchten, legen Sie die Eigenschaft published
für diese Datei in der Eigenschaft Überarbeitungen fest. Diese Eigenschaft kann nicht über die Drive API für Google Sites-Überarbeitungen festgelegt werden.
Wenn die Datei in einer Google Workspace -Domain erstellt wird, gibt das Attribut publishedOutsideDomain
an, ob die Überarbeitung für jeden zugänglich ist oder ob sie auf Nutzer der Domain beschränkt ist. Bei Google Sites-Dateien gibt diese Eigenschaft an, ob eine type=anyone
-Berechtigung vorhanden ist.
Veröffentlichte Überarbeitungen spiegeln keine Änderungen an einer Datei wider, es sei denn, die Eigenschaft publishAuto
ist festgelegt. Wenn diese Eigenschaft auf "true" gesetzt ist, werden neuere Versionen einer Datei automatisch veröffentlicht, wobei die vorherigen überschrieben werden. Das wird auch über das Kästchen „Automatisch neu veröffentlichen, wenn Änderungen vorgenommen wurden“ gesteuert. Bei Google Sites-Dateien ist publishAuto
immer false
.