REST Resource: revisions

Ressource: Revision

Eine Version einer Datei.

Für einige Ressourcenmethoden (z. B. revisions.update) ist ein revisionId erforderlich. Verwenden Sie die Methode revisions.list, um die ID für eine Revision abzurufen.

JSON-Darstellung
{
  "exportLinks": {
    string: string,
    ...
  },
  "id": string,
  "mimeType": string,
  "kind": string,
  "published": boolean,
  "etag": string,
  "pinned": boolean,
  "md5Checksum": string,
  "modifiedDate": string,
  "lastModifyingUserName": string,
  "downloadUrl": string,
  "publishAuto": boolean,
  "publishedOutsideDomain": boolean,
  "publishedLink": string,
  "fileSize": string,
  "originalFilename": string,
  "lastModifyingUser": {
    object (User)
  },
  "selfLink": string
}
Felder
id

string

Nur Ausgabe. Die ID der Überarbeitung.

mimeType

string

Nur Ausgabe. Der MIME-Typ der Version.

kind

string

Nur Ausgabe. Dies ist immer drive#revision.

published

boolean

Gibt an, ob diese Version veröffentlicht ist. Dieses Feld wird nur für Dateien in den Docs-Editoren ausgefüllt und kann nur für diese Dateien geändert werden.

etag

string

Nur Ausgabe. Das ETag der Revision.

pinned

boolean

Gibt an, ob diese Überarbeitung angepinnt ist, um das automatische Löschen zu verhindern. Wenn nichts festgelegt ist, wird die Überarbeitung 30 Tage nach dem Hochladen neuerer Inhalte automatisch gelöscht. Dieses Feld kann nur für Dateien mit Inhalten geändert werden, die in Drive gespeichert sind. Dateien der Docs-Editoren sind davon ausgenommen. Revisionen können auch angepinnt werden, wenn sie über „drive.files.insert/update/copy“ mit dem Abfrageparameter „pinned“ erstellt werden. Angepinnte Versionen werden unbegrenzt gespeichert und belegen zusätzlichen Speicherplatz. Es können maximal 200 Versionen angepinnt werden.

md5Checksum

string

Nur Ausgabe. Eine MD5-Prüfsumme für den Inhalt dieser Überarbeitung. Diese Informationen werden nur für Dateien mit Inhalten angezeigt, die in Drive gespeichert sind.

modifiedDate

string

Nur Ausgabe. Zeitpunkt der letzten Änderung dieser Überarbeitung (formatiert als RFC 3339-Zeitstempel).

lastModifyingUserName

string

Nur Ausgabe. Name des letzten Nutzers, der diese Überarbeitung geändert hat.

downloadUrl

string

Nur Ausgabe. Kurzfristige Download-URL für die Datei. Diese Informationen werden nur für Dateien mit Inhalten angezeigt, die in Drive gespeichert sind.

publishAuto

boolean

Gibt an, ob nachfolgende Überarbeitungen automatisch neu veröffentlicht werden. Dieses Feld wird nur für Dateien in den Docs-Editoren ausgefüllt und kann nur für diese Dateien geändert werden.

publishedOutsideDomain

boolean

Gibt an, ob diese Überarbeitung außerhalb der Domain veröffentlicht wird. Dieses Feld wird nur für Dateien in den Docs-Editoren ausgefüllt und kann nur für diese Dateien geändert werden.

fileSize

string (int64 format)

Nur Ausgabe. Die Größe der Überarbeitung in Byte. Diese Informationen werden nur für Dateien mit Inhalten angezeigt, die in Drive gespeichert sind.

originalFilename

string

Nur Ausgabe. Der ursprüngliche Dateiname, als diese Version erstellt wurde. Diese Informationen werden nur für Dateien mit Inhalten angezeigt, die in Drive gespeichert sind.

lastModifyingUser

object (User)

Nur Ausgabe. Der letzte Nutzer, der diese Version geändert hat. Dieses Feld wird nur ausgefüllt, wenn die letzte Änderung von einem angemeldeten Nutzer vorgenommen wurde.

Methoden

delete

Löscht eine Dateiversion endgültig.

get

Ruft eine bestimmte Überarbeitung ab.

list

Listet die Überarbeitungen einer Datei auf.

patch

Aktualisiert eine Version.

update

Aktualisiert eine Version.