Dateiüberarbeitungen herunterladen und veröffentlichen

Die Google Drive API bietet die Ressource Überarbeitungen, damit Sie Dateiversionen herunterladen und veröffentlichen können. Weitere Informationen zur Terminologie von Überarbeitungen finden Sie unter Änderungen und Überarbeitungen – Übersicht.

Überarbeitungen angeben, die aus dem automatischen Löschen gespeichert werden sollen

Ältere Versionen, die für den Nutzer nicht mehr interessant 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 von Drive nicht dauerhaft gelöscht werden sollen.

Überarbeitung herunterladen

Sie können den Wert des Felds headRevisionId aus der Ressource Dateien verwenden, um die neueste Version herunterzuladen. Dadurch wird die Version abgerufen, die den Metadaten der zuvor abgerufenen Datei entspricht. Wenn Sie die Daten aller vorherigen Versionen der Datei herunterladen möchten, die noch in der Cloud gespeichert sind, können Sie revisions.list aufrufen, um alle Versions-IDs abzurufen.

Hinweis: Der Zugriff auf frühere Überarbeitungen ist je nach Rolle eingeschränkt. Überprüfen Sie die capabilities.canReadRevisions-Feld in file vor versuchen, darauf zuzugreifen.

Um den Inhalt der Überarbeitung herunterzuladen, müssen Sie Die Methode revisions.get mit dem Parameter alt=media. Überarbeitungen für Google Docs, Google Tabellen und Google Präsentationen können nicht heruntergeladen werden.

Hinweis: Wenn Sie die ältere Version der Drive API Version 2 verwenden, müssen Sie eine autorisierte GET-Anfrage an die zugehörige downloadUrl-Property. Google Drive generiert diese kurzlebige URL beim Anfordern der Überarbeitung an. Verlassen Sie sich nicht auf sie für die spätere Verwendung. Sie können die Überarbeitung auch in einem der unterstützten Formate exportieren, indem Sie das Kästchen exportLinks.

In Google Docs, Google Zeichnungen und Google Präsentationen werden die Überarbeitungen automatisch erhöht. Die Zahlenreihen können jedoch Lücken aufweisen, wenn Überarbeitungen gelöscht werden. Daher 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 im Attribut Überarbeitungen das Attribut published für diese Datei fest. Dieses Attribut kann für Google Sites-Überarbeitungen nicht über die Drive API festgelegt werden.

Wird die Datei in einer Google Workspace Domain erstellt, Das Attribut publishedOutsideDomain gibt an, ob die Überarbeitung für jeden zugänglich oder auf Nutzer der Domain beschränkt ist. Für Google Sites-Dateien an, ob eine type=anyone-Berechtigung vorhanden ist.

Veröffentlichte Überarbeitungen spiegeln Änderungen an einer Datei nur dann wider, wenn das Attribut publishAuto festgelegt ist. Wenn dieses Attribut auf „true“ gesetzt ist, werden neuere Überarbeitungen einer Datei automatisch veröffentlicht und die vorherigen werden überschrieben. Dieses Verhalten wird auch über die Einstellung "Automatisch neu veröffentlichen, wenn Änderungen vorgenommen wurden" gesteuert. in der Drive-Benutzeroberfläche. Bei Google Sites-Dateien ist publishAuto immer false.