REST Resource: files

Ressource: Datei

Die Metadaten für eine Datei.

Für einige Ressourcenmethoden (z. B. files.update) ist ein fileId erforderlich. Verwenden Sie die Methode files.list, um die ID einer Datei abzurufen.

JSON-Darstellung 
{
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "hasThumbnail": boolean,
  "folderColorRgb": string,
  "id": string,
  "name": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "createdTime": string,
  "modifiedTime": string,
  "modifiedByMeTime": string,
  "viewedByMeTime": string,
  "sharedWithMeTime": string,
  "quotaBytesUsed": string,
  "version": string,
  "originalFilename": string,
  "ownedByMe": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": 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,
    "canChangeItemDownloadRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "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,
    "time": 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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean,
  "downloadRestrictions": {
    object (DownloadRestrictionsMetadata)
  }
}
Felder
parents[]

string

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 als Teil einer Erstellungsanfrage angegeben wird, wird die Datei direkt im Ordner „Meine Ablage“ des Nutzers platziert. Wenn sie nicht als Teil einer Kopieranfrage angegeben wird, erbt die Datei alle auffindbaren übergeordneten Elemente der Quelldatei. Für Aktualisierungsanfragen müssen die Parameter addParents und removeParents verwendet werden, um die Liste der übergeordneten Elemente zu ändern.
owners[]

object (User)

Nur Ausgabe. Der Eigentümer dieser Datei. Nur bestimmte alte Dateien haben möglicherweise mehrere Eigentümer. Dieses Feld wird für Elemente in geteilten Ablagen nicht ausgefüllt.
permissions[]

object (Permission)

Nur Ausgabe. Die vollständige Liste der Berechtigungen für die Datei. Diese Option ist nur verfügbar, wenn der anfragende Nutzer die Datei freigeben kann. Für Elemente in geteilten Ablagen nicht ausgefüllt.
spaces[]

string

Nur Ausgabe. Die Liste der Bereiche, die die Datei enthalten. Die derzeit unterstützten Werte sind drive, appDataFolder und photos.
properties

map (key: string, value: value (Value format))

Eine Sammlung beliebiger Schlüssel/Wert-Paare, die für alle Apps sichtbar sind.

Einträge mit Nullwerten werden in Aktualisierungs- und Kopieranfragen gelöscht.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
appProperties

map (key: string, value: value (Value format))

Eine Sammlung beliebiger Schlüssel/Wert-Paare, die für die anfragende App privat sind.

Einträge mit Nullwerten werden in Aktualisierungs- und Kopieranfragen gelöscht.

Diese Eigenschaften können nur mit einer authentifizierten Anfrage abgerufen werden. Für eine authentifizierte Anfrage wird ein Zugriffstoken verwendet, das mit einer OAuth 2.0-Client-ID abgerufen wurde. Sie können keinen API-Schlüssel verwenden, um private Properties abzurufen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
permissionIds[]

string

Nur Ausgabe. Liste der Berechtigungs-IDs für Nutzer mit Zugriff auf diese Datei.
contentRestrictions[]

object (ContentRestriction)

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

string

Nur Ausgabe. Kennzeichnet, welche Art von Ressource dies ist. Wert: der feste String "drive#file".
driveId

string

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

string

Nur Ausgabe. Die letzte Komponente von fullFileExtension. Diese Funktion ist nur für Dateien mit binärem Inhalt in Google Drive verfügbar.
copyRequiresWriterPermission

boolean

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

string

Nur Ausgabe. Die MD5-Prüfsumme für den Inhalt der Datei. Das gilt nur für Dateien mit binären Inhalten in Google Drive.
contentHints

object

Zusätzliche Informationen zum Inhalt der Datei. Diese Felder werden in Antworten nie ausgefüllt.
contentHints.indexableText

string

Text, der für die Datei indexiert werden soll, um Volltextabfragen zu verbessern. Die Länge ist auf 128 KB begrenzt und das Feld kann HTML-Elemente enthalten.
contentHints.thumbnail

object

Eine Miniaturansicht der Datei. Diese wird nur verwendet, wenn in Google Drive kein Standard-Thumbnail generiert werden kann.
contentHints.thumbnail.image

string (bytes format)

Die mit URL-sicherem Base64 (RFC 4648, Abschnitt 5) codierten Vorschaubilddaten.

Ein base64-codierter String.
contentHints.thumbnail.mimeType

string

Der MIME-Typ des Thumbnails.
writersCanShare

boolean

Gibt an, ob Nutzer mit der Berechtigung writer die Berechtigungen der Datei ändern können. Für Elemente in geteilten Ablagen nicht ausgefüllt.
viewedByMe

boolean

Nur Ausgabe. Gibt an, ob die Datei von diesem Nutzer aufgerufen wurde.
mimeType

string

Der MIME-Typ der Datei.

Google Drive versucht, automatisch einen geeigneten Wert aus hochgeladenen Inhalten zu erkennen, wenn kein Wert angegeben wird. Der Wert kann nur geändert werden, wenn eine neue Version hochgeladen wird.

Wenn eine Datei mit einem Google-Dokument-MIME-Typ erstellt wird, werden die hochgeladenen Inhalte nach Möglichkeit importiert. Die unterstützten Importformate werden in der Ressource about veröffentlicht.
shared

boolean

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

object (User)

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

string

Nur Ausgabe. Die ID der Head-Revision der Datei. Diese Funktion ist derzeit nur für Dateien mit binären Inhalten in Google Drive verfügbar.
sharingUser

object (User)

Nur Ausgabe. Der Nutzer, der die Datei für den anfragenden Nutzer freigegeben hat (falls zutreffend).
webContentLink

string

Nur Ausgabe. Ein Link zum Herunterladen des Inhalts der Datei in einem Browser. Diese Funktion ist nur für Dateien mit binärem Inhalt in Google Drive verfügbar.
size

string (int64 format)

Nur Ausgabe. Größe von Blobs und Google Workspace-Editor-Dateien in Byte. Wird für Dateien ohne Größe, z. B. Verknüpfungen und Ordner, nicht ausgefüllt.
viewersCanCopyContent
(deprecated)

boolean

Verworfen: Verwenden Sie stattdessen copyRequiresWriterPermission.
hasThumbnail

boolean

Nur Ausgabe. Gibt an, ob diese Datei ein Thumbnail hat. Das bedeutet nicht, dass die anfragende App Zugriff auf die Miniaturansicht hat. Prüfen Sie, ob das Feld „thumbnailLink“ vorhanden ist, um den Zugriff zu prüfen.
folderColorRgb

string

Die Farbe für einen Ordner oder eine Verknüpfung zu einem Ordner als RGB-Hexadezimalstring. Die unterstützten Farben werden im Feld folderColorPalette der Ressource about veröffentlicht.

Wenn eine nicht unterstützte Farbe angegeben wird, wird stattdessen die nächstgelegene Farbe in der Palette verwendet.
id

string

Die ID der Datei.
name

string

Der Name der Datei. Sie muss nicht unbedingt innerhalb eines Ordners eindeutig sein. Bei unveränderlichen Elementen wie den Ordnern der obersten Ebene von geteilten Ablagen, dem Stammordner von „Meine Ablage“ und dem Ordner „Anwendungsdaten“ ist der Name konstant.
description

string

Eine kurze Beschreibung der Datei.
starred

boolean

Gibt an, ob der Nutzer die Datei mit einem Sternchen markiert hat.
trashed

boolean

Gibt an, ob die Datei explizit oder durch einen gelöschten übergeordneten Ordner in den Papierkorb verschoben wurde. Nur der Eigentümer kann eine Datei in den Papierkorb verschieben. Andere Nutzer können Dateien im Papierkorb des Eigentümers nicht sehen.
explicitlyTrashed

boolean

Nur Ausgabe. Gibt an, ob die Datei explizit in den Papierkorb verschoben wurde oder rekursiv aus einem übergeordneten Ordner.
createdTime

string

Die Uhrzeit, zu der die Datei erstellt wurde (RFC 3339-Datum/Uhrzeit).
modifiedTime

string

Der Zeitpunkt, zu dem die Datei zuletzt von jemandem geändert wurde (RFC 3339-Datum/Uhrzeit).

Wenn Sie modifiedTime festlegen, wird auch modifiedByMeTime für den Nutzer aktualisiert.
modifiedByMeTime

string

Nur Ausgabe. Der Zeitpunkt, zu dem die Datei zuletzt vom Nutzer geändert wurde (RFC 3339-Datum/Uhrzeit).
viewedByMeTime

string

Der Zeitpunkt, zu dem die Datei zuletzt vom Nutzer aufgerufen wurde (RFC 3339-Datum/Uhrzeit).
sharedWithMeTime

string

Nur Ausgabe. Die Uhrzeit, zu der die Datei für den Nutzer freigegeben wurde, falls zutreffend (RFC 3339-Datum/Uhrzeit).
quotaBytesUsed

string (int64 format)

Nur Ausgabe. Die Anzahl der vom Speicherkontingent verwendeten Byte der Datei. Dazu gehören die aktuelle Version sowie frühere Versionen, für die keepForever aktiviert ist.
version

string (int64 format)

Nur Ausgabe. Eine monoton steigende Versionsnummer für die Datei. Hier werden alle Änderungen an der Datei auf dem Server angezeigt, auch solche, die für den Nutzer nicht sichtbar sind.
originalFilename

string

Der ursprüngliche Dateiname der hochgeladenen Inhalte, sofern verfügbar, oder der ursprüngliche Wert des Felds name. Diese Funktion ist nur für Dateien mit binärem Inhalt in Google Drive verfügbar.
ownedByMe

boolean

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

string

Nur Ausgabe. Die vollständige Dateiendung, die aus dem Feld name extrahiert wurde. Kann mehrere verkettete Erweiterungen enthalten, z. B. „tar.gz“. Diese Funktion ist nur für Dateien mit binärem Inhalt in Google Drive verfügbar.

Dieses Feld wird automatisch aktualisiert, wenn sich das Feld name ändert. Es wird jedoch nicht gelöscht, wenn der neue Name keine gültige Erweiterung enthält.
isAppAuthorized

boolean

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

string

Veraltet: Nur Ausgabe. Verwenden Sie stattdessen driveId.
capabilities

object

Nur Ausgabe. Funktionen, die der aktuelle Nutzer für diese Datei hat. Jede Funktion entspricht einer detaillierten Aktion, die ein Nutzer ausführen kann. Weitere Informationen finden Sie unter Dateifunktionen.
capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

Veraltet: Nur Ausgabe.
capabilities.canMoveChildrenOutOfDrive

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners aus der geteilten Ablage verschieben kann. Dies ist false, 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. Beispiele finden Sie unter canChangeCopyRequiresWriterPermission oder canModifyContent.
capabilities.canCopy

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diese Datei kopieren kann. Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Elements, die keine Ordner sind, oder dieses Element selbst kopieren kann, wenn es kein Ordner ist.
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 untergeordnete Elemente 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. Gibt an, ob Revisionen von untergeordneten Elementen dieses Elements, die keine Ordner sind, oder dieses Element selbst (falls es kein Ordner ist) gelesen werden können.
capabilities.canReadTeamDrive
(deprecated)

boolean

Veraltet: Nur Ausgabe. Verwenden Sie stattdessen canReadDrive.
capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Veraltet: Nur Ausgabe. 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

Veraltet: Nur Ausgabe. 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

Veraltet: Nur Ausgabe. Verwenden Sie stattdessen canMoveItemWithinDrive.
capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Veraltet: Nur Ausgabe. Verwenden Sie stattdessen canMoveItemOutOfDrive.
capabilities.canDeleteChildren

boolean

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

boolean

Veraltet: Nur Ausgabe. Verwenden Sie stattdessen canMoveChildrenOutOfDrive.
capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Veraltet: Nur Ausgabe. 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 false, 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 aus dieser Ablage verschieben kann, indem er den übergeordneten Ordner ändert. Eine Anfrage zum Ändern des übergeordneten Elements des Artikels kann jedoch weiterhin fehlschlagen, je nachdem, welches neue übergeordnete Element hinzugefügt wird.
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 einen Elternteil aus dem Element entfernen kann, ohne in derselben Anfrage einen anderen Elternteil hinzuzufügen. Für Dateien in geteilten Ablagen nicht ausgefüllt.
capabilities.canMoveItemWithinDrive

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer dieses Element in dieser Ablage verschieben kann. Eine Anfrage zum Ändern des übergeordneten Elements des Artikels kann jedoch weiterhin fehlschlagen, je nachdem, welches neue übergeordnete Element hinzugefügt und welches entfernt wird.
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 in dieser Ablage verschieben kann. Dies ist false, wenn das Element kein Ordner ist. Eine Anfrage zum Verschieben des untergeordneten Elements kann jedoch weiterhin fehlschlagen, je nachdem, welchen Zugriff der aktuelle Nutzer auf das untergeordnete Element und den Zielordner hat.
capabilities.canModifyContentRestriction
(deprecated)

boolean

Veraltet: Nur Ausgabe. Verwenden Sie canModifyEditorContentRestriction, canModifyOwnerContentRestriction oder canRemoveContentRestriction.
capabilities.canAddFolderFromAnotherDrive

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer einen Ordner aus einem anderen Laufwerk (einer anderen geteilten Ablage oder „Meine Ablage“) in diesen Ordner einfügen kann. Dies ist false, 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 auf Bearbeiter beschränkt sind.
capabilities.canModifyOwnerContentRestriction

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Inhaltsbeschränkungen hinzufügen oder ändern kann, die nur vom Inhaber festgelegt werden können.
capabilities.canRemoveContentRestriction

boolean

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

boolean

Ob ein Nutzer übernommene Berechtigungen deaktivieren kann.
capabilities.canEnableInheritedPermissions

boolean

Ob ein Nutzer übernommene Berechtigungen wieder aktivieren kann.
capabilities.canChangeItemDownloadRestriction

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer die vom Eigentümer oder Organisator angewendeten Downloadbeschränkungen der Datei ändern kann.
hasAugmentedPermissions

boolean

Nur Ausgabe. Gibt an, ob für diese Datei direkte Berechtigungen 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, der Nutzer, der sie in den Papierkorb verschoben hat. Wird nur für Elemente in geteilten Ablagen ausgefüllt.
thumbnailVersion

string (int64 format)

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

string

Nur Ausgabe. Der Zeitpunkt, zu dem das Element in den Papierkorb verschoben wurde (RFC 3339-Datum/Uhrzeit). Wird nur für Elemente in geteilten Ablagen ausgefüllt.
modifiedByMe

boolean

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

object

Nur Ausgabe. Zusätzliche Metadaten zu Bildmedien, falls verfügbar.
imageMediaMetadata.flashUsed

boolean

Nur Ausgabe. Gibt an, ob beim Erstellen des Fotos ein Blitz verwendet wurde.
imageMediaMetadata.meteringMode

string

Nur Ausgabe. Der zum Erstellen des Fotos verwendete Messmodus.
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 90-Grad-Drehungen im Uhrzeigersinn, die auf die ursprüngliche Ausrichtung des Bildes angewendet wurden.
imageMediaMetadata.time

string

Nur Ausgabe. Datum und Uhrzeit der Aufnahme des Fotos (EXIF-DateTime).
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 Länge der Belichtung in Sekunden.
imageMediaMetadata.aperture

number

Nur Ausgabe. Die Blende, die zum Erstellen des Fotos verwendet wurde (Blendenwert).
imageMediaMetadata.focalLength

number

Nur Ausgabe. Die Brennweite, die zum 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, das zum Erstellen des Fotos verwendet wurde.
videoMediaMetadata

object

Nur Ausgabe. Zusätzliche Metadaten zu Videomedia. Sie ist möglicherweise nicht sofort nach dem Upload 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.create-Anfragen festgelegt werden.
shortcutDetails.targetId

string

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

string

Nur Ausgabe. Der MIME-Typ der Datei, auf die diese Verknüpfung verweist. Der Wert dieses Felds ist ein Snapshot des MIME-Typs des Ziels, der beim Erstellen der Verknüpfung aufgenommen wurde.
shortcutDetails.targetResourceKey

string

Nur Ausgabe. Die resourceKey für die Zieldatei.
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 über die Labels der Datei.
labelInfo.labels[]

object (Label)

Nur Ausgabe. Die Gruppe von Labels in der Datei, die 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 dieser Datei zugeordnet ist, sofern verfügbar. Dieses Feld wird nur für Dateien mit Inhalten ausgefüllt, die in Google Drive gespeichert sind. Für Dateien der Docs-Editoren oder Verknüpfungsdateien wird es nicht 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. Für Dateien der Docs-Editoren oder Verknüpfungsdateien wird es nicht ausgefüllt.
inheritedPermissionsDisabled

boolean

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

object (DownloadRestrictionsMetadata)

Für die Datei gelten Downloadeinschränkungen.

ContentRestriction

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

JSON-Darstellung 
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionTime": 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. Außerdem können keine Kommentare hinzugefügt oder geändert werden und der Titel der Datei kann nicht geändert werden.
reason

string

Grund für die Einschränkung des Inhalts der Datei. Dieses Feld kann nur in Anfragen geändert werden, in denen auch readOnly=true festgelegt ist.
type

string

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

object (User)

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

string

Nur Ausgabe. Die Uhrzeit, zu der die Inhaltsbeschränkung festgelegt wurde (formatiert als RFC 3339-Datum/Uhrzeit). Wird nur ausgefüllt, wenn readOnly=true.
ownerRestricted

boolean

Ob die Inhaltsbeschränkung nur von einem Nutzer geändert oder entfernt werden kann, 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. Gibt an, ob die Inhaltsbeschränkung vom System angewendet wurde, z. B. aufgrund einer elektronischen Signatur. Nutzer können keine Einschränkungen für systembeschränkte Inhalte ändern oder entfernen.

DownloadRestrictionsMetadata

Für die Datei gelten Downloadeinschränkungen.

JSON-Darstellung 
{
  "itemDownloadRestriction": {
    object (DownloadRestriction)
  },
  "effectiveDownloadRestrictionWithContext": {
    object (DownloadRestriction)
  }
}
Felder
itemDownloadRestriction

object (DownloadRestriction)

Die Downloadbeschränkung der Datei wurde direkt vom Eigentümer oder Organisator angewendet. Einstellungen für geteilte Ablagen oder DLP-Regeln werden dabei nicht berücksichtigt.
effectiveDownloadRestrictionWithContext

object (DownloadRestriction)

Nur Ausgabe. Die effektive Downloadeinschränkung, die für diese Datei gilt. Dabei werden alle Einschränkungseinstellungen und DLP-Regeln berücksichtigt.

DownloadRestriction

Eine Einschränkung für das Kopieren und Herunterladen der Datei.

JSON-Darstellung 
{
  "restrictedForReaders": boolean,
  "restrictedForWriters": boolean
}
Felder
restrictedForReaders

boolean

Gibt an, ob das Herunterladen und Kopieren für Leser eingeschränkt ist.
restrictedForWriters

boolean

Gibt an, ob das Herunterladen und Kopieren für Nutzer mit Schreibzugriff eingeschränkt ist. Wenn true, ist der Download auch für Leser eingeschränkt.

Methoden

copy

 Erstellt eine Kopie einer Datei und wendet alle angeforderten Updates mit Patch-Semantik an.

create

Erstellt eine Datei.

delete

 Löscht eine Datei, die dem Nutzer gehört, endgültig, ohne sie in den Papierkorb zu verschieben.

download

 Lädt den Inhalt einer Datei herunter.

emptyTrash

 Löscht alle Dateien des Nutzers im Papierkorb endgültig.

export

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

generateIds

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

get

Ruft Metadaten oder Inhalte einer Datei anhand der ID ab.

list

Listet die Dateien des Nutzers auf.

listLabels

 Listet die Labels für eine Datei auf.

modifyLabels

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

update

Aktualisiert die Metadaten, den Inhalt oder beides einer Datei.

watch

 Abonniert Änderungen an einer Datei.