Dateiüberarbeitungen herunterladen und veröffentlichen

Ü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.