REST Resource: files

Ressource: Datei

Die Metadaten für eine Datei.

Einige Ressourcenmethoden (z. B. files.update) erfordern eine fileId. Verwenden Sie die Methode files.list, um die ID für eine Datei abzurufen.

JSON-Darstellung
{
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "ownerNames": [
    string
  ],
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "driveId": string,
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "properties": [
    {
      object (Property)
    }
  ],
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "title": string,
  "description": string,
  "labels": {
    "viewed": boolean,
    "restricted": boolean,
    "starred": boolean,
    "hidden": boolean,
    "trashed": boolean,
    "modified": boolean
  },
  "explicitlyTrashed": boolean,
  "createdDate": string,
  "modifiedDate": string,
  "modifiedByMeDate": string,
  "lastViewedByMeDate": string,
  "markedViewedByMeDate": string,
  "sharedWithMeDate": string,
  "quotaBytesUsed": string,
  "version": string,
  "indexableText": {
    "text": string
  },
  "originalFilename": string,
  "ownedByMe": boolean,
  "canComment": boolean,
  "shareable": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeRestrictedDownload": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": string,
  "permissionIds": [
    string
  ],
  "thumbnail": {
    "image": string,
    "mimeType": string
  },
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "date": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string
}
Felder
kind

string

Nur Ausgabe. Der Dateityp. Dies ist immer drive#file.

userPermission

object (Permission)

Nur Ausgabe. Die Berechtigungen für den authentifizierten Nutzer für diese Datei.

fileExtension

string

Nur Ausgabe. Die letzte Komponente von fullFileExtension mit abschließendem Text, der offenbar nicht Teil der Erweiterung ist. Dieses Feld wird nur für Dateien mit Inhalten gefüllt, die in Google Drive gespeichert sind. wird er für Docs-Editoren oder Verknüpfungsdateien nicht automatisch ausgefüllt.

md5Checksum

string

Nur Ausgabe. Eine MD5-Prüfsumme für den Inhalt dieser Datei. Dieses Feld wird nur für Dateien mit Inhalten gefüllt, die in Google Drive gespeichert sind. wird er für Docs-Editoren oder Verknüpfungsdateien nicht automatisch ausgefüllt.

ownerNames[]

string

Nur Ausgabe. Namen der Eigentümer dieser Datei. Wird für Elemente in geteilten Ablagen nicht ausgefüllt.

lastModifyingUserName

string

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

editable
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Verwende stattdessen capabilities/canEdit.

writersCanShare

boolean

Ob Autoren das Dokument für andere Nutzer freigeben können Wird für Elemente in geteilten Ablagen nicht ausgefüllt.

downloadUrl

string

Nur Ausgabe. Kurzlebige Download-URL für die Datei. Dieses Feld wird nur für Dateien mit Inhalten gefüllt, die in Google Drive gespeichert sind. wird er bei Google Docs-Dateien oder Verknüpfungsdateien nicht automatisch ausgefüllt.

mimeType

string

Der MIME-Typ der Datei. Diese Einstellung kann nur beim Hochladen neuer Inhalte geändert werden. Dieses Feld kann leer bleiben und der MIME-Typ wird anhand des MIME-Typs des hochgeladenen Inhalts ermittelt.

driveId

string

Nur Ausgabe. ID der geteilten Ablage, in der sich die Datei befindet. Das Feld wird nur für Elemente in geteilten Ablagen ausgefüllt.

parents[]

object (ParentReference)

Die ID des übergeordneten Ordners, der die Datei enthält.

Eine Datei kann nur einen übergeordneten Ordner haben. Die Angabe mehrerer übergeordneter Elemente wird nicht unterstützt.

Wenn die Datei nicht im Rahmen einer Einfügeanfrage angegeben wird, wird sie direkt im Ordner „Meine Ablage“ des Nutzers platziert. Wenn nicht im Rahmen einer Kopieranfrage angegeben, übernimmt die Datei alle sichtbaren übergeordneten Elemente der Quelldatei. Für „files.update“-Anfragen müssen die Parameter addParents und removeParents verwendet werden, um die Liste der übergeordneten Elemente zu ändern.

appDataContents

boolean

Nur Ausgabe. Gibt an, ob sich die Datei im Ordner „Anwendungsdaten“ befindet.

shared

boolean

Nur Ausgabe. Gibt an, ob die Datei freigegeben wurde. Wird für Elemente in geteilten Ablagen nicht ausgefüllt.

lastModifyingUser

object (User)

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

owners[]

object (User)

Nur Ausgabe. Der Eigentümer dieser Datei. Nur bestimmte ältere Dateien können mehr als einen Eigentümer haben. Bei Elementen in geteilten Ablagen wird dieses Feld nicht ausgefüllt.

headRevisionId

string

Nur Ausgabe. Die ID der Hauptüberarbeitung der Datei. Dieses Feld wird nur für Dateien mit Inhalten gefüllt, die in Google Drive gespeichert sind. wird er für Docs-Editoren oder Verknüpfungsdateien nicht automatisch ausgefüllt.

properties[]

object (Property)

Die Liste der Attribute.

copyable
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Verwende stattdessen capabilities/canCopy.

etag

string

Nur Ausgabe. Das ETag der Datei.

sharingUser

object (User)

Nur Ausgabe. Nutzer, der das Element für den aktuellen Nutzer freigegeben hat, sofern verfügbar.

fileSize

string (int64 format)

Nur Ausgabe. Größe in Byte von Blobs und eigenen Editordateien. Wird nicht für Dateien ohne Größe ausgefüllt, z. B. Verknüpfungen und Ordner.

copyRequiresWriterPermission

boolean

Gibt an, ob die Optionen zum Kopieren, Drucken oder Herunterladen dieser Datei für Leser und Kommentatoren deaktiviert werden sollen.

permissions[]

object (Permission)

Nur Ausgabe. Die Liste der Berechtigungen für Nutzer mit Zugriff auf diese Datei. Wird für Elemente in geteilten Ablagen nicht ausgefüllt.

hasThumbnail

boolean

Nur Ausgabe. Gibt an, ob diese Datei eine Miniaturansicht hat. Dies bedeutet nicht, ob die anfragende App Zugriff auf das Thumbnail hat. Um den Zugriff zu prüfen, suchen Sie nach dem Feld „thumbnailLink“.

spaces[]

string

Nur Ausgabe. Die Liste der Leerzeichen, die die Datei enthalten. Unterstützte Werte sind drive, appDataFolder und photos.

folderColorRgb

string

Ordnerfarbe als hexadezimaler RGB-String, wenn die Datei ein Ordner oder eine Verknüpfung zu einem Ordner ist. Die Liste der unterstützten Farben finden Sie im FeldfolderColorPalette der Ressource Info. Wenn eine nicht unterstützte Farbe angegeben wird, wird sie auf die nächstgelegene Farbe in der Palette geändert.

id

string

Die ID der Datei.

title

string

Der Titel dieser Datei. Hinweis: Bei unveränderlichen Elementen wie den Ordnern der obersten Ebene von geteilten Ablagen, dem Stammordner „Meine Ablage“ und dem Ordner „Anwendungsdaten“ bleibt der Titel gleich.

description

string

Eine kurze Beschreibung der Datei.

labels

object

Eine Gruppe von Labels für die Datei.

labels.viewed

boolean

Gibt an, ob die Datei von diesem Nutzer angesehen wurde.

labels.restricted
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Verwende stattdessen copyRequiresWriterPermission.

labels.starred

boolean

Gibt an, ob diese Datei vom Nutzer markiert ist.

labels.hidden
(deprecated)

boolean

Nur Ausgabe. Verworfen.

labels.trashed

boolean

Gibt an, ob die Datei in den Papierkorb verschoben wurde. Dieses Label gilt für alle Nutzer, die auf die Datei zugreifen. Allerdings können nur Eigentümer Dateien ansehen und in den Papierkorb verschieben.

labels.modified

boolean

Nur Ausgabe. Gibt an, ob die Datei von diesem Nutzer geändert wurde.

explicitlyTrashed

boolean

Nur Ausgabe. Gibt an, ob diese Datei explizit in den Papierkorb verschoben wurde (im Gegensatz zu rekursiv).

createdDate

string

Nur Ausgabe. Erstellungszeitpunkt für diese Datei (formatierter RFC 3339-Zeitstempel)

modifiedDate

string

Der Zeitpunkt, zu dem diese Datei zuletzt von jemandem geändert wurde (formatierter RFC 3339-Zeitstempel) Der Parameter kann bei einer Aktualisierung nur dann geändert werden, wenn der Parameter „setModifiedDate“ festgelegt ist.

modifiedByMeDate

string

Nur Ausgabe. Zeitpunkt der letzten Änderung dieser Datei durch den Nutzer (formatierter RFC 3339-Zeitstempel) Wenn Sie „ModifiedDate“ festlegen, wird auch das „modifyByMe“-Datum für den Nutzer aktualisiert, der das Datum festgelegt hat.

lastViewedByMeDate

string

Letzter Aufruf dieser Datei durch den Nutzer (formatierter RFC 3339-Zeitstempel)

markedViewedByMeDate
(deprecated)

string

Nur Ausgabe. Verworfen.

sharedWithMeDate

string

Nur Ausgabe. Zeitpunkt, zu dem diese Datei für den Nutzer freigegeben wurde (formatierter RFC 3339-Zeitstempel).

quotaBytesUsed

string (int64 format)

Nur Ausgabe. Die Anzahl der Kontingentbyte, die von dieser Datei verwendet werden.

version

string (int64 format)

Nur Ausgabe. Eine kontinuierlich ansteigende Versionsnummer für die Datei. Dies spiegelt jede Änderung wider, die an der Datei auf dem Server vorgenommen wurde, auch solche, die für den anfordernden Nutzer nicht sichtbar sind.

indexableText

object

Indexierbare Textattribute für die Datei (können nur geschrieben werden)

indexableText.text

string

Der Text, der für diese Datei indexiert werden soll.

originalFilename

string

Der ursprüngliche Dateiname des hochgeladenen Inhalts, falls verfügbar, oder der ursprüngliche Wert des Felds title. Diese Option ist nur für Dateien mit binären Inhalten in Google Drive verfügbar.

ownedByMe

boolean

Nur Ausgabe. Gibt an, ob die Datei dem aktuellen Nutzer gehört. Wird für Elemente in geteilten Ablagen nicht ausgefüllt.

canComment
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Verwende stattdessen capabilities/canComment.

shareable
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Verwende stattdessen capabilities/canShare.

fullFileExtension

string

Nur Ausgabe. Die vollständige Dateiendung aus dem Titel extrahiert. Kann mehrere verkettete Erweiterungen enthalten, z. B. „tar.gz“. Wenn Sie eine Erweiterung aus dem Titel entfernen, wird dieses Feld nicht gelöscht. Wenn Sie jedoch die Erweiterung des Titels ändern, wird dieses Feld aktualisiert. Dieses Feld wird nur für Dateien mit Inhalten gefüllt, die in Google Drive gespeichert sind. wird er für Docs-Editoren oder Verknüpfungsdateien nicht automatisch ausgefüllt.

isAppAuthorized

boolean

Nur Ausgabe. Gibt an, ob die Datei von der anfragenden App erstellt oder geöffnet wurde.

teamDriveId
(deprecated)

string

Nur Ausgabe. Eingestellt: Verwende stattdessen driveId.

capabilities

object

Nur Ausgabe. Funktionen, die der aktuelle Nutzer für diese Datei hat. Jede Fähigkeit entspricht einer detaillierten Aktion, die ein Benutzer ausführen kann.

capabilities.canChangeRestrictedDownload
(deprecated)

boolean

Nur Ausgabe. Verworfen.

capabilities.canMoveChildrenOutOfDrive

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners aus der geteilten Ablage verschieben kann. Dieser Wert ist falsch, wenn das Element kein Ordner ist. Das Feld wird nur für Elemente in geteilten Ablagen ausgefüllt.

capabilities.canReadDrive

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die geteilte Ablage lesen kann, zu der die Datei gehört. Das Feld wird nur für Elemente in geteilten Ablagen ausgefüllt.

capabilities.canEdit

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diese Datei bearbeiten kann. Andere Faktoren können die Art der Änderungen einschränken, die ein Nutzer an einer Datei vornehmen kann. Siehe beispielsweise canChangeCopyRequiresWriterPermission oder canModifyContent.

capabilities.canCopy

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diese Datei kopieren kann. Gibt bei einem Element in einer geteilten Ablage an, ob der aktuelle Nutzer Nachfolgerelemente dieses Elements kopieren kann, die nicht zum Ordner gehören, oder das Element selbst, wenn es kein Ordner ist.

capabilities.canComment

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diese Datei kommentieren darf.

capabilities.canAddChildren

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diesem Ordner untergeordnete Elemente hinzufügen kann. Dieser Wert ist immer falsch, wenn das Element kein Ordner ist.

capabilities.canDelete

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diese Datei löschen kann.

capabilities.canDownload

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diese Datei herunterladen kann.

capabilities.canListChildren

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die untergeordneten Elemente dieses Ordners auflisten kann. Dieser Wert ist immer falsch, wenn das Element kein Ordner ist.

capabilities.canRemoveChildren

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer untergeordnete Elemente aus diesem Ordner entfernen kann. Dieser Wert ist immer falsch, wenn das Element kein Ordner ist. Verwenden Sie für einen Ordner in einer geteilten Ablage stattdessen canDeleteChildren oder canTrashChildren.

capabilities.canRename

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diese Datei umbenennen kann.

capabilities.canTrash

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die Datei in den Papierkorb verschieben kann.

capabilities.canReadRevisions

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die Versionsressource dieser Datei lesen kann. Bei einem Element in einer geteilten Ablage kann gelesen werden, ob Überarbeitungen von Nachfolgerelemente dieses Elements, die kein Ordner sind, oder dieses Element selbst, wenn es kein Ordner ist.

capabilities.canReadTeamDrive
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Verwende stattdessen canReadDrive.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Verwende stattdessen canMoveItemWithinDrive oder canMoveItemOutOfDrive.

capabilities.canChangeCopyRequiresWriterPermission

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die Einschränkung „copyRequiresWriterPermission“ für diese Datei ändern kann.

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Verwende stattdessen canMoveItemOutOfDrive.

capabilities.canUntrash

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diese Datei aus dem Papierkorb wiederherstellen kann.

capabilities.canModifyContent

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer den Inhalt dieser Datei ändern kann.

capabilities.canMoveItemWithinTeamDrive
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Verwende stattdessen canMoveItemWithinDrive.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Verwende stattdessen canMoveItemOutOfDrive.

capabilities.canDeleteChildren

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners löschen kann. Dieser Wert ist falsch, wenn das Element kein Ordner ist. Wird nur für Elemente in geteilten Ablagen ausgefüllt.

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Verwende stattdessen canMoveChildrenOutOfDrive.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Verwende stattdessen canMoveChildrenWithinDrive.

capabilities.canTrashChildren

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners in den Papierkorb verschieben kann. Dieser Wert ist falsch, wenn das Element kein Ordner ist. Das Feld wird nur für Elemente in geteilten Ablagen ausgefüllt.

capabilities.canMoveItemOutOfDrive

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer dieses Element außerhalb dieses Laufwerks verschieben kann, indem er das übergeordnete Element ändert. Je nachdem, welches übergeordnete Element gerade hinzugefügt wird, kann eine Anfrage zum Ändern des übergeordneten Elements trotzdem fehlschlagen.

capabilities.canAddMyDriveParent

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer dem Element ein übergeordnetes Element hinzufügen kann, ohne in derselben Anfrage ein übergeordnetes Element zu entfernen. Für Dateien in geteilten Ablagen nicht ausgefüllt.

capabilities.canRemoveMyDriveParent

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer einen übergeordneten Nutzer aus dem Element entfernen kann, ohne in derselben Anfrage ein weiteres übergeordnetes Element hinzuzufügen. Für Dateien in geteilten Ablagen nicht ausgefüllt.

capabilities.canMoveItemWithinDrive

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer dieses Element innerhalb dieses Laufwerks verschieben kann. Je nach dem neuen übergeordneten Element, das hinzugefügt wird, und dem zu entfernenden übergeordneten Element, kann eine Anfrage zum Ändern des übergeordneten Elements trotzdem fehlschlagen.

capabilities.canShare

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die Freigabeeinstellungen für diese Datei ändern kann.

capabilities.canMoveChildrenWithinDrive

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners innerhalb dieses Laufwerks verschieben kann. Dieser Wert ist falsch, wenn das Element kein Ordner ist. Je nachdem, welche Zugriffsrechte der aktuelle Nutzer auf den untergeordneten Ordner und den Zielordner hat, kann das Verschieben des untergeordneten Ordners trotzdem fehlschlagen.

capabilities.canModifyContentRestriction
(deprecated)

boolean

Verworfen: Nur Ausgabe. Verwende entweder canModifyEditorContentRestriction, canModifyOwnerContentRestriction oder canRemoveContentRestriction.

capabilities.canAddFolderFromAnotherDrive

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diesem Ordner einen Ordner aus einer anderen geteilten Ablage oder „Meine Ablage“ hinzufügen kann. Dieser Wert ist falsch, wenn das Element kein Ordner ist. Das Feld wird nur für Elemente in geteilten Ablagen ausgefüllt.

capabilities.canChangeSecurityUpdateEnabled

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer das Feld „securityUpdateEnabled“ in den Metadaten zur Linkfreigabe ändern kann.

capabilities.canAcceptOwnership

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer der ausstehende Eigentümer der Datei ist. Für Dateien in geteilten Ablagen nicht ausgefüllt.

capabilities.canReadLabels

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die Labels in der Datei lesen kann.

capabilities.canModifyLabels

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die Labels der Datei ändern kann.

capabilities.canModifyEditorContentRestriction

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Inhaltsbeschränkungen für die Datei hinzufügen oder ändern kann, für die der Editor eingeschränkt ist.

capabilities.canModifyOwnerContentRestriction

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Inhaltsbeschränkungen hinzufügen oder ändern kann, für die eine Beschränkung des Eigentümers festgelegt ist.

capabilities.canRemoveContentRestriction

boolean

Nur Ausgabe. Gibt an, ob für die Datei eine Inhaltsbeschränkung besteht, die vom aktuellen Nutzer entfernt werden kann.

hasAugmentedPermissions

boolean

Nur Ausgabe. Gibt an, ob Berechtigungen direkt für diese Datei vorhanden sind. Dieses Feld wird nur für Elemente in geteilten Ablagen ausgefüllt.

trashingUser

object (User)

Nur Ausgabe. Wenn die Datei explizit in den Papierkorb verschoben wurde, ist dies der Nutzer, der sie in den Papierkorb verschoben hat. Das Feld wird nur für Elemente in geteilten Ablagen ausgefüllt.

canReadRevisions
(deprecated)

boolean

Nur Ausgabe. Eingestellt: Verwende stattdessen capabilities/canReadRevisions.

thumbnailVersion

string (int64 format)

Nur Ausgabe. Die Thumbnail-Version, die bei der Cache-Entwertung von Miniaturansichten verwendet wird.

trashedDate

string

Nur Ausgabe. Der Zeitpunkt, zu dem das Element in den Papierkorb verschoben wurde (formatierter RFC 3339-Zeitstempel). Das Feld wird nur für Elemente in geteilten Ablagen ausgefüllt.

permissionIds[]

string

Nur Ausgabe. files.list der Berechtigungs-IDs für Nutzer mit Zugriff auf diese Datei.

thumbnail

object

Eine Miniaturansicht für die Datei. Wird nur verwendet, wenn kein Standard-Thumbnail generiert werden kann.

thumbnail.image

string (bytes format)

Die URL-sicheren Base64-codierten Byte des Bilds der Miniaturansicht. Sie sollte Abschnitt 5 von RFC 4648 einhalten.

Ein base64-codierter String.

thumbnail.mimeType

string

Der MIME-Typ der Miniaturansicht.

imageMediaMetadata

object

Nur Ausgabe. Metadaten zu Bildmedien. Dies ist nur bei Bildtypen vorhanden und ihr Inhalt hängt davon ab, was aus dem Bildinhalt geparst werden kann.

imageMediaMetadata.flashUsed

boolean

Nur Ausgabe. Gibt an, ob zur Erstellung des Fotos ein Blitz verwendet wurde.

imageMediaMetadata.meteringMode

string

Nur Ausgabe. Der zur Erstellung des Fotos verwendete Messmodus.

imageMediaMetadata.sensor

string

Nur Ausgabe. Der Sensortyp, mit dem das Foto aufgenommen wurde.

imageMediaMetadata.exposureMode

string

Nur Ausgabe. Der zur Aufnahme des Fotos verwendete Belichtungsmodus.

imageMediaMetadata.colorSpace

string

Nur Ausgabe. Der Farbraum des Fotos.

imageMediaMetadata.whiteBalance

string

Nur Ausgabe. Der zur Erstellung des Fotos verwendete Weißabgleichmodus.

imageMediaMetadata.width

integer

Nur Ausgabe. Die Breite des Bilds in Pixeln

imageMediaMetadata.height

integer

Nur Ausgabe. Die Höhe des Bilds in Pixeln

imageMediaMetadata.location

object

Nur Ausgabe. Geografische Standortinformationen, die im Bild gespeichert sind.

imageMediaMetadata.location.latitude

number

Nur Ausgabe. Der im Bild gespeicherte Breitengrad.

imageMediaMetadata.location.longitude

number

Nur Ausgabe. Der im Bild gespeicherte Längengrad.

imageMediaMetadata.location.altitude

number

Nur Ausgabe. Die im Bild gespeicherte Höhe.

imageMediaMetadata.rotation

integer

Nur Ausgabe. Die Anzahl der 90-Grad-Drehungen im Uhrzeigersinn, die ausgehend von der ursprünglichen Ausrichtung des Bilds angewendet wurden.

imageMediaMetadata.date

string

Nur Ausgabe. Datum und Uhrzeit der Aufnahme des Fotos (Zeitstempel im EXIF-Format).

imageMediaMetadata.cameraMake

string

Nur Ausgabe. Die Marke der Kamera, mit der das Foto aufgenommen wurde.

imageMediaMetadata.cameraModel

string

Nur Ausgabe. Das Modell der Kamera, mit der das Foto erstellt wurde.

imageMediaMetadata.exposureTime

number

Nur Ausgabe. Die Dauer der Belichtung in Sekunden.

imageMediaMetadata.aperture

number

Nur Ausgabe. Die für die Aufnahme des Fotos verwendete Blende (Blendenzahl).

imageMediaMetadata.focalLength

number

Nur Ausgabe. Die Brennweite in Millimeter, die zur Erstellung des Fotos verwendet wurde.

imageMediaMetadata.isoSpeed

integer

Nur Ausgabe. Die zur Erstellung des Fotos verwendete ISO-Empfindlichkeit.

imageMediaMetadata.exposureBias

number

Nur Ausgabe. Die Belichtungskorrektur des Fotos (APEX-Wert).

imageMediaMetadata.maxApertureValue

number

Nur Ausgabe. Die kleinste Blendenzahl des Objektivs bei der Brennweite, mit der das Foto aufgenommen wurde (APEX-Wert).

imageMediaMetadata.subjectDistance

integer

Nur Ausgabe. Die Entfernung zum Motiv des Fotos in Metern.

imageMediaMetadata.lens

string

Nur Ausgabe. Das für die Aufnahme verwendete Objektiv.

videoMediaMetadata

object

Nur Ausgabe. Metadaten zu Videomedien. Dies ist nur bei Videotypen vorhanden.

videoMediaMetadata.width

integer

Nur Ausgabe. Die Breite des Videos in Pixeln.

videoMediaMetadata.height

integer

Nur Ausgabe. Die Höhe des Videos in Pixeln.

videoMediaMetadata.durationMillis

string (int64 format)

Nur Ausgabe. Dauer des Videos in Millisekunden.

shortcutDetails

object

Details zur Verknüpfungsdatei. Wird nur für Verknüpfungsdateien ausgefüllt, bei denen das Feld „mimeType“ auf application/vnd.google-apps.shortcut gesetzt ist. Kann nur für files.insert-Anfragen festgelegt werden.

shortcutDetails.targetId

string

Die ID der Datei, auf die diese Verknüpfung verweist. Kann nur für files.insert-Anfragen festgelegt werden.

shortcutDetails.targetMimeType

string

Nur Ausgabe. Der MIME-Typ der Datei, auf die diese Verknüpfung verweist. Der Wert dieses Feldes ist eine Momentaufnahme des MIME-Typs des Ziels, der beim Erstellen der Verknüpfung erfasst wird.

shortcutDetails.targetResourceKey

string

Nur Ausgabe. Der ResourceKey für die Zieldatei.

contentRestrictions[]

object (ContentRestriction)

Einschränkungen für den Zugriff auf den Inhalt der Datei Das Feld wird nur ausgefüllt, wenn eine solche Einschränkung vorhanden ist.

resourceKey

string

Nur Ausgabe. Ein Schlüssel, der für den Zugriff auf das Element über einen freigegebenen Link erforderlich ist.

linkShareMetadata.securityUpdateEligible

boolean

Nur Ausgabe. Gibt an, ob die Datei für ein Sicherheitsupdate infrage kommt.

linkShareMetadata.securityUpdateEnabled

boolean

Nur Ausgabe. Gibt an, ob das Sicherheitsupdate für diese Datei aktiviert ist.

labelInfo

object

Nur Ausgabe. Eine Übersicht der Labels in der Datei.

labelInfo.labels[]

object (Label)

Nur Ausgabe. Der Satz Labels für die Datei, wie von den Label-IDs im Parameter includeLabels angefordert. Standardmäßig werden keine Labels zurückgegeben.

sha1Checksum

string

Nur Ausgabe. Die mit dieser Datei verknüpfte SHA1-Prüfsumme, falls verfügbar. Dieses Feld wird nur für Dateien mit Inhalten gefüllt, die in Google Drive gespeichert sind. wird er für Docs-Editoren oder Verknüpfungsdateien nicht automatisch ausgefüllt.

sha256Checksum

string

Nur Ausgabe. Die mit dieser Datei verknüpfte SHA256-Prüfsumme, falls verfügbar. Dieses Feld wird nur für Dateien mit Inhalten gefüllt, die in Google Drive gespeichert sind. wird er bei Docs-Editoren oder Verknüpfungsdateien nicht automatisch ausgefüllt.

ContentRestriction

Eine Einschränkung für den Zugriff auf den Inhalt der Datei.

JSON-Darstellung
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionDate": string,
  "ownerRestricted": boolean,
  "systemRestricted": boolean
}
Felder
readOnly

boolean

Gibt an, ob der Inhalt der Datei schreibgeschützt ist. Wenn eine Datei schreibgeschützt ist, wird möglicherweise keine neue Version der Datei hinzugefügt, keine Kommentare hinzugefügt oder geändert und der Titel der Datei kann nicht geändert werden.

reason

string

Grund, warum der Inhalt der Datei eingeschränkt ist. Dies kann nur bei Anfragen geändert werden, für die auch readOnly=true festgelegt ist.

type

string

Nur Ausgabe. Die Art der Inhaltsbeschränkung. Der einzig mögliche Wert ist derzeit globalContentRestriction.

restrictingUser

object (User)

Nur Ausgabe. Der Nutzer, der die Inhaltsbeschränkung festgelegt hat. Wird nur ausgefüllt, wenn readOnly „true“ ist.

restrictionDate

string

Nur Ausgabe. Der Zeitpunkt, zu dem die Inhaltsbeschränkung festgelegt wurde (formatierter RFC 3339-Zeitstempel). Wird nur ausgefüllt, wenn readOnly „true“ ist.

ownerRestricted

boolean

Gibt an, ob die Inhaltsbeschränkung nur von einem Nutzer, der Eigentümer der Datei ist, geändert oder entfernt werden kann. Bei Dateien in geteilten Ablagen kann jeder Nutzer mit organizer-Berechtigungen diese Inhaltsbeschränkung ändern oder entfernen.

systemRestricted

boolean

Nur Ausgabe. Gibt an, ob die Inhaltsbeschränkung vom System angewendet wurde, z. B. aufgrund einer E-Signatur. Nutzer können vom System eingeschränkte Inhaltsbeschränkungen nicht ändern oder entfernen.

Methoden

copy

Erstellt eine Kopie der angegebenen Datei.

delete

Löscht eine Datei, deren Eigentümer der Nutzer ist, endgültig, ohne sie in den Papierkorb zu verschieben.

emptyTrash

Damit werden alle in den Papierkorb verschobenen Dateien des Nutzers endgültig gelöscht.

export

Exportiert ein Google Workspace-Dokument in den angeforderten MIME-Typ und gibt exportierten Byte-Inhalt zurück.

generateIds

Generiert eine Reihe von Datei-IDs, die in Einfüge- oder Kopieranfragen angegeben werden können.

get

Ruft die Metadaten oder den Inhalt einer Datei nach ID ab.

insert

Fügt eine neue Datei ein.

list

Listet die Dateien des Nutzers auf.

listLabels

Listet die Labels einer Datei auf.

modifyLabels

Ändert die auf eine Datei angewendeten Labels.

patch

Aktualisiert die Metadaten und/oder den Inhalt einer Datei.

touch

Legt die aktualisierte Zeit der Datei auf die aktuelle Serverzeit fest.

trash

Verschiebt die Datei in den Papierkorb.

untrash

Stellt eine Datei aus dem Papierkorb wieder her.

update

Aktualisiert die Metadaten und/oder den Inhalt einer Datei.

watch

Abonniert Änderungen an einer Datei.