REST Resource: files

Ressource: Datei

Die Metadaten einer Datei.

Für einige Ressourcenmethoden (z. B. files.update) ist eine fileId erforderlich. 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,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": 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,
  "inheritedPermissionsDisabled": boolean
}
Felder
kind

string

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

userPermission

object (Permission)

Nur Ausgabe. Die Berechtigungen des authentifizierten Nutzers für diese Datei.

fileExtension

string

Nur Ausgabe. Die letzte Komponente von fullFileExtension mit dem nachgestellten Text, der nicht Teil der Erweiterung zu sein scheint, wurde entfernt. Dieses Feld wird nur für Dateien mit Inhalten ausgefüllt, die in Google Drive gespeichert sind. Es wird nicht für Docs-Editoren oder Verknüpfungsdateien 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 ausgefüllt, die in Google Drive gespeichert sind. Es wird nicht für Docs-Editoren oder Verknüpfungsdateien ausgefüllt.

ownerNames[]

string

Nur Ausgabe. Name(s) des Eigentümers bzw. der Eigentümer dieser Datei. Wird für Elemente in geteilten Ablagen nicht ausgefüllt.

lastModifyingUserName

string

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

editable
(deprecated)

boolean

Nur Ausgabe. Verworfen. Verwenden Sie stattdessen capabilities/canEdit.

writersCanShare

boolean

Ob Mitbearbeiter 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 ausgefüllt, die in Google Drive gespeichert sind. Es wird nicht für Google Docs-Dateien oder Verknüpfungsdateien ausgefüllt.

mimeType

string

Der MIME-Typ der Datei. Dieser Wert kann nur beim Aktualisieren geändert werden, wenn neue Inhalte hochgeladen werden. Dieses Feld kann leer bleiben. Der MIME-Typ wird dann anhand des MIME-Typs der hochgeladenen Inhalte ermittelt.

driveId

string

Nur Ausgabe. ID der geteilten Ablage, in der sich die Datei befindet. 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 Ordner wird nicht unterstützt.

Wenn sie nicht im Rahmen einer Anfrage zum Einfügen angegeben wird, wird die Datei direkt im Ordner „Meine Ablage“ des Nutzers abgelegt. Wenn dies nicht im Rahmen einer Kopierbenachrichtigung angegeben wird, übernimmt die Datei alle auffindbaren übergeordneten Elemente der Quelldatei. Bei Aktualisierungsanfragen für Dateien müssen die Parameter addParents und removeParents verwendet werden, um die Liste der übergeordneten Elemente zu ändern.

appDataContents

boolean

Nur Ausgabe. Ob sich diese Datei im Ordner „Anwendungsdaten“ befindet.

shared

boolean

Nur Ausgabe. Ob die Datei freigegeben wurde. Wird für Elemente in geteilten Ablagen nicht ausgefüllt.

lastModifyingUser

object (User)

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

owners[]

object (User)

Nur Ausgabe. Der Eigentümer dieser Datei. Nur bestimmte alte Dateien können mehrere Inhaber haben. Dieses Feld wird für Elemente in geteilten Ablagen nicht ausgefüllt.

headRevisionId

string

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

properties[]

object (Property)

Die Liste der Properties.

copyable
(deprecated)

boolean

Nur Ausgabe. Verworfen. Verwenden Sie stattdessen capabilities/canCopy.

etag

string

Nur Ausgabe. ETag der Datei.

sharingUser

object (User)

Nur Ausgabe. Der 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 Editordateien von Drittanbietern. Wird für Dateien ohne Größe nicht ausgefüllt, z. B. für Verknüpfungen und Ordner.

copyRequiresWriterPermission

boolean

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 ein Thumbnail hat. Das gibt keinen Hinweis darauf, ob die anfragende App Zugriff auf das Thumbnail hat. Prüfe, ob das Feld „thumbnailLink“ vorhanden ist.

spaces[]

string

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

folderColorRgb

string

Ordnerfarbe als RGB-Hexadezimalstring, wenn die Datei ein Ordner oder eine Verknüpfung zu einem Ordner ist. Die Liste der unterstützten Farben finden Sie im Feld „folderColorPalette“ der Inforessource. Wenn eine nicht unterstützte Farbe angegeben wird, wird sie in die Farbe in der Palette geändert, die ihr am nächsten kommt.

id

string

Die ID der Datei.

title

string

Der Titel dieser Datei. Bei unveränderlichen Elementen wie den Ordnern der obersten Ebene von geteilten Ablagen, dem Stammverzeichnis von „Meine Ablage“ und dem Ordner „Anwendungsdaten“ ist der Titel konstant.

description

string

Eine kurze Beschreibung der Datei.

labels

object

Eine Gruppe von Labels für die Datei.

labels.viewed

boolean

Gibt an, ob diese Datei von diesem Nutzer aufgerufen wurde.

labels.restricted
(deprecated)

boolean

Nur Ausgabe. Verworfen. Verwenden Sie stattdessen copyRequiresWriterPermission.

labels.starred

boolean

Gibt an, ob diese Datei vom Nutzer mit einem Stern markiert wurde.

labels.hidden
(deprecated)

boolean

Nur Ausgabe. Verworfen.

labels.trashed

boolean

Gibt an, ob diese Datei im Papierkorb ist. Dieses Label gilt für alle Nutzer, die auf die Datei zugreifen. Nur Eigentümer dürfen Dateien im Papierkorb sehen und wiederherstellen.

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, anstatt rekursiv in den Papierkorb verschoben zu werden.

createdDate

string

Nur Ausgabe. Erstellungszeit dieser Datei (formatierter RFC 3339-Zeitstempel).

modifiedDate

string

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

modifiedByMeDate

string

Nur Ausgabe. Zeitpunkt, zu dem diese Datei zuletzt vom Nutzer geändert wurde (formatierter RFC 3339-Zeitstempel). Hinweis: Wenn Sie das Datum „modifiedDate“ festlegen, wird auch das Datum „modifiedByMe“ für den Nutzer aktualisiert, der das Datum festgelegt hat.

lastViewedByMeDate

string

Datum und Uhrzeit, zu dem sich der Nutzer diese Datei zuletzt angesehen hat (formatiert als RFC 3339-Zeitstempel).

markedViewedByMeDate
(deprecated)

string

Nur Ausgabe. Verworfen.

sharedWithMeDate

string

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

quotaBytesUsed

string (int64 format)

Nur Ausgabe. Die Anzahl der von dieser Datei verwendeten Kontingent-Byte.

version

string (int64 format)

Nur Ausgabe. Eine monoton ansteigende Versionsnummer für die Datei. Dies spiegelt alle Änderungen wider, die an der Datei auf dem Server vorgenommen wurden, auch solche, die für den anfragenden 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 der hochgeladenen Inhalte, sofern verfügbar, oder der ursprüngliche Wert des Felds title. Diese Funktion ist nur für Dateien mit binären Inhalten in Google Drive verfügbar.

ownedByMe

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer der Inhaber der Datei ist. Wird für Elemente in geteilten Ablagen nicht ausgefüllt.

canComment
(deprecated)

boolean

Nur Ausgabe. Verworfen. Verwenden Sie stattdessen capabilities/canComment.

shareable
(deprecated)

boolean

Nur Ausgabe. Verworfen. Verwenden Sie stattdessen capabilities/canShare.

fullFileExtension

string

Nur Ausgabe. Die vollständige Dateiendung, die aus dem Titel extrahiert wird. Kann mehrere zusammengesetzte Erweiterungen enthalten, z. B. „tar.gz“. Wenn Sie eine Erweiterung aus dem Titel entfernen, wird dieses Feld nicht gelöscht. Wenn Sie die Erweiterung im Titel ändern, wird dieses Feld jedoch aktualisiert. Dieses Feld wird nur für Dateien mit Inhalten ausgefüllt, die in Google Drive gespeichert sind. Es wird nicht für Docs-Editoren oder Verknüpfungsdateien 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. Verworfen. Verwenden Sie stattdessen driveId.

capabilities

object

Nur Ausgabe. Berechtigungen, die der aktuelle Nutzer für diese Datei hat. Jede Funktion entspricht einer detaillierten Aktion, die ein Nutzer 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 außerhalb der geteilten Ablage verschieben kann. Dies ist falsch, wenn das Element kein Ordner ist. 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 diese Datei gehört. 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. Beispiel: canChangeCopyRequiresWriterPermission oder canModifyContent.

capabilities.canCopy

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diese Datei kopieren kann. Gibt an, ob der aktuelle Nutzer Elemente in einer geteilten Ablage kopieren kann, die keine Ordner sind, oder das Element selbst, wenn es sich nicht um einen Ordner handelt.

capabilities.canComment

boolean

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

capabilities.canAddChildren

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diesem Ordner untergeordnete Elemente hinzufügen kann. Wenn das Element kein Ordner ist, ist dieser Wert immer „false“.

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. Wenn das Element kein Ordner ist, ist dieser Wert immer „false“.

capabilities.canRemoveChildren

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Kinder aus diesem Ordner entfernen kann. Wenn das Element kein Ordner ist, ist dieser Wert immer „false“. 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 diese Datei in den Papierkorb verschieben kann.

capabilities.canReadRevisions

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die Revisionsressource dieser Datei lesen kann. Für ein Element in einer geteilten Ablage können Revisionen von nicht-ordnerbezogenen Nachkommen dieses Elements oder dieses Element selbst gelesen werden, wenn es sich nicht um einen Ordner handelt.

capabilities.canReadTeamDrive
(deprecated)

boolean

Nur Ausgabe. Verworfen. Verwenden Sie stattdessen canReadDrive.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Nur Ausgabe. Verworfen. Verwenden Sie stattdessen canMoveItemWithinDrive oder canMoveItemOutOfDrive.

capabilities.canChangeCopyRequiresWriterPermission

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die copyRequiresWriterPermission-Einschränkung dieser Datei ändern kann.

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

Nur Ausgabe. Verworfen. Verwenden Sie 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. Verworfen. Verwenden Sie stattdessen canMoveItemWithinDrive.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Nur Ausgabe. Verworfen. Verwenden Sie stattdessen canMoveItemOutOfDrive.

capabilities.canDeleteChildren

boolean

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

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

Nur Ausgabe. Verworfen. Verwenden Sie stattdessen canMoveChildrenOutOfDrive.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Nur Ausgabe. Verworfen. Verwenden Sie stattdessen canMoveChildrenWithinDrive.

capabilities.canTrashChildren

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners in den Papierkorb verschieben kann. Dies ist falsch, wenn das Element kein Ordner ist. 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 nach hinzugefügtem übergeordnetem Element kann eine Anfrage zum Ändern des übergeordneten Elements des Artikels dennoch fehlschlagen.

capabilities.canAddMyDriveParent

boolean

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

capabilities.canRemoveMyDriveParent

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer ein übergeordnetes Element aus dem Element entfernen kann, ohne in derselben Anfrage ein anderes ü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 hinzugefügten und dem entfernten übergeordneten Element kann eine Anfrage zum Ändern des übergeordneten Elements des Artikels 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. Dies ist falsch, wenn das Element kein Ordner ist. Je nach Zugriff des aktuellen Nutzers auf das untergeordnete Element und den Zielordner kann eine Anfrage zum Verschieben des untergeordneten Elements fehlschlagen.

capabilities.canModifyContentRestriction
(deprecated)

boolean

Nicht mehr unterstützt: Nur Ausgabe. Verwenden Sie 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 aus „Meine Ablage“ hinzufügen kann. Dies ist falsch, wenn das Element kein Ordner ist. 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 für die Linkfreigabe ändern kann.

capabilities.canAcceptOwnership

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer der ausstehende Inhaber 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 für die 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, die für Bearbeiter eingeschränkt sind.

capabilities.canModifyOwnerContentRestriction

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Inhaltsbeschränkungen hinzufügen oder ändern kann, die vom Inhaber eingeschränkt sind.

capabilities.canRemoveContentRestriction

boolean

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

capabilities.canDisableInheritedPermissions

boolean

Nur Ausgabe. Ob ein Nutzer übernommene Berechtigungen deaktivieren kann.

capabilities.canEnableInheritedPermissions

boolean

Nur Ausgabe. Ob ein Nutzer übernommene Berechtigungen wieder aktivieren kann.

hasAugmentedPermissions

boolean

Nur Ausgabe. Ob es direkte Berechtigungen für diese Datei gibt. 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, der Nutzer, der sie dorthin verschoben hat. Wird nur für Elemente in geteilten Ablagen ausgefüllt.

canReadRevisions
(deprecated)

boolean

Nur Ausgabe. Verworfen. Verwenden Sie stattdessen capabilities/canReadRevisions.

thumbnailVersion

string (int64 format)

Nur Ausgabe. Die Thumbnail-Version, die für die Cache-Entwertung von Thumbnails verwendet werden soll.

trashedDate

string

Nur Ausgabe. Die Zeit, zu der der Artikel in den Papierkorb verschoben wurde (formatierter RFC 3339-Zeitstempel). Wird nur für Elemente in geteilten Ablagen ausgefüllt.

permissionIds[]

string

Gibt nur die Berechtigungs-IDs für Nutzer mit Zugriff auf diese Datei aus.

thumbnail

object

Eine Miniaturansicht der Datei. Diese Option wird nur verwendet, wenn kein Standard-Thumbnail generiert werden kann.

thumbnail.image

string (bytes format)

Die URL-sicheren Base64-codierten Bytes des Thumbnail-Bildes. Sie muss RFC 4648 Abschnitt 5 entsprechen.

Ein base64-codierter String.

thumbnail.mimeType

string

Der MIME-Typ des Thumbnails.

imageMediaMetadata

object

Nur Ausgabe. Metadaten zu Bildmedien. Dieser Wert ist nur für Bildtypen vorhanden und sein Inhalt hängt davon ab, was aus dem Bildinhalt geparst werden kann.

imageMediaMetadata.flashUsed

boolean

Nur Ausgabe. Gibt an, ob für das Foto ein Blitz verwendet wurde.

imageMediaMetadata.meteringMode

string

Nur Ausgabe. Der Belichtungsmodus, der zum Erstellen des Fotos verwendet wurde.

imageMediaMetadata.sensor

string

Nur Ausgabe. Der Sensortyp, der zum Erstellen des Fotos verwendet wurde.

imageMediaMetadata.exposureMode

string

Nur Ausgabe. Der Belichtungsmodus, der zum Erstellen des Fotos verwendet wurde.

imageMediaMetadata.colorSpace

string

Nur Ausgabe. Der Farbraum des Fotos.

imageMediaMetadata.whiteBalance

string

Nur Ausgabe. Der Weißabgleichsmodus, der zum Erstellen des Fotos verwendet wurde.

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. Im Bild gespeicherte Informationen zum geografischen Standort.

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 Drehungen um 90 Grad im Uhrzeigersinn, die von der ursprünglichen Ausrichtung des Bildes aus 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 aufgenommen wurde.

imageMediaMetadata.exposureTime

number

Nur Ausgabe. Die Belichtungszeit in Sekunden.

imageMediaMetadata.aperture

number

Nur Ausgabe. Die Blende, die zum Erstellen des Fotos verwendet wurde (Blendenzahl).

imageMediaMetadata.focalLength

number

Nur Ausgabe. Die Brennweite, die beim Erstellen des Fotos verwendet wurde, in Millimetern.

imageMediaMetadata.isoSpeed

integer

Nur Ausgabe. Die ISO-Empfindlichkeit, die zum Erstellen des Fotos verwendet wurde.

imageMediaMetadata.exposureBias

number

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

imageMediaMetadata.maxApertureValue

number

Nur Ausgabe. Die kleinste Blendenzahl des Objektivs bei der Brennweite, die zum Erstellen des Fotos verwendet wurde (APEX-Wert).

imageMediaMetadata.subjectDistance

integer

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

imageMediaMetadata.lens

string

Nur Ausgabe. Das Objektiv, mit dem das Foto aufgenommen wurde.

videoMediaMetadata

object

Nur Ausgabe. Metadaten zu Videomedien. Diese Option ist nur für Videotypen verfügbar.

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 dieser Verknüpfungspunkt verweist. Kann nur für files.insert-Anfragen festgelegt werden.

shortcutDetails.targetMimeType

string

Nur Ausgabe. Der MIME-Typ der Datei, auf die dieser Verknüpfungspunkt verweist. Der Wert dieses Felds ist ein Snapshot des MIME-Typs des Ziels, der beim Erstellen des Symbols erfasst wurde.

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. Wird nur ausgefüllt, wenn eine solche Einschränkung vorliegt.

resourceKey

string

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

linkShareMetadata.securityUpdateEligible

boolean

Nur Ausgabe. Gibt an, ob für die Datei ein Sicherheitsupdate verfügbar ist.

linkShareMetadata.securityUpdateEnabled

boolean

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

labelInfo

object

Nur Ausgabe. Eine Übersicht über die Labels der Datei.

labelInfo.labels[]

object (Label)

Nur Ausgabe. Die Labels in der Datei, wie sie durch die Label-IDs im Parameter includeLabels angefordert wurden. Standardmäßig werden keine Labels zurückgegeben.

sha1Checksum

string

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

sha256Checksum

string

Nur Ausgabe. Die SHA256-Prüfsumme, die mit dieser Datei verknüpft ist, sofern verfügbar. Dieses Feld wird nur für Dateien mit Inhalten ausgefüllt, die in Google Drive gespeichert sind. Es wird nicht für Docs-Editoren oder Verknüpfungsdateien ausgefüllt.

inheritedPermissionsDisabled

boolean

Gibt an, ob die übernommenen Berechtigungen für diese Datei deaktiviert sind. Übernommene Berechtigungen sind standardmäßig aktiviert.

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, kann keine neue Version der Datei hinzugefügt werden. Kommentare können nicht hinzugefügt oder geändert werden und der Titel der Datei kann nicht geändert werden.

reason

string

Grund für die Einschränkung der Inhalte der Datei. Dieser Wert kann nur für Anfragen geändert werden, bei denen auch readOnly=true festgelegt ist.

type

string

Nur Ausgabe. Der Typ der Inhaltsbeschränkung. Derzeit ist globalContentRestriction der einzige mögliche Wert.

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. Die Uhrzeit, zu der 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 geändert oder entfernt werden kann, der der Eigentümer der Datei ist. Bei Dateien in geteilten Ablagen kann jeder Nutzer mit organizer-Berechtigungen diese Inhaltsbeschränkung ändern oder entfernen.

systemRestricted

boolean

Nur Ausgabe. Ob die Inhaltsbeschränkung vom System angewendet wurde, z. B. aufgrund einer E-Signatur. Nutzer können die Einschränkungen für systembeschränkte Inhalte nicht ändern oder entfernen.

Methoden

copy

Erstellt eine Kopie der angegebenen Datei.

delete

Dateien, die dem Nutzer gehören, werden endgültig gelöscht, ohne in den Papierkorb verschoben zu werden.

emptyTrash

Alle Dateien im Papierkorb des Nutzers werden endgültig gelöscht.

export

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

generateIds

Generiert eine Reihe von Datei-IDs, die in Insert- oder Copy-Anfragen angegeben werden können.

get

Ruft die Metadaten oder den Inhalt einer Datei anhand der ID ab.

insert

Hiermit wird eine neue Datei eingefügt.

list

Listet die Dateien des Nutzers auf.

listLabels

Listet die Labels einer Datei auf.

modifyLabels

Ändert die Labels, die auf eine Datei angewendet werden.

patch

Aktualisiert die Metadaten und/oder den Inhalt einer Datei.

touch

Legen Sie die Aktualisierungszeit der Datei auf die aktuelle Serverzeit fest.

trash

Verschiebt eine 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.