Diese Seite wurde von der Cloud Translation API übersetzt.

REST Resource: files

Ressource: Datei
- JSON-Darstellung
  - JSON-Darstellung
- ContentRestriction
  - JSON-Darstellung
Methoden

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

JSON-Darstellung
{ "ownerNames": [ string ], "exportLinks": { string: string, ... }, "parents": [ { object (`ParentReference`) } ], "owners": [ { object (`User`) } ], "openWithLinks": { string: string, ... }, "properties": [ { object (`Property`) } ], "permissions": [ { object (`Permission`) } ], "spaces": [ string ], "permissionIds": [ string ], "contentRestrictions": [ { object (`ContentRestriction`) } ], "kind": string, "userPermission": { object (`Permission`) }, "fileExtension": string, "md5Checksum": string, "selfLink": string, "lastModifyingUserName": string, "editable": boolean, "writersCanShare": boolean, "downloadUrl": string, "mimeType": string, "driveId": string, "thumbnailLink": string, "appDataContents": boolean, "webViewLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "defaultOpenWithLink": string, "headRevisionId": string, "copyable": boolean, "etag": string, "sharingUser": { object (`User`) }, "alternateLink": string, "embedLink": string, "webContentLink": string, "fileSize": string, "copyRequiresWriterPermission": boolean, "hasThumbnail": boolean, "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, "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 }, "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean }, "labelInfo": { "labels": [ { object (`Label`) } ] }, "sha1Checksum": string, "sha256Checksum": string, "inheritedPermissionsDisabled": boolean }

{
  "ownerNames": [
    string
  ],
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "properties": [
    {
      object (Property)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "driveId": string,
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "hasThumbnail": boolean,
  "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,
  "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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}

Felder
`ownerNames[]`	`string` Nur Ausgabe. Name(n) des/der Eigentümer(s) dieser Datei. Für Elemente in geteilten Ablagen nicht ausgefüllt.
`exportLinks`	`map (key: string, value: string)` Nur Ausgabe. Links zum Exportieren von Dateien aus den Docs-Editoren in bestimmte Formate. Ein Objekt, das eine Liste von `"key": value`-Paaren enthält. Beispiel: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`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 die Datei nicht als Teil einer Einfügeanfrage angegeben wird, wird sie direkt im Ordner „Meine Ablage“ des Nutzers platziert. Wenn sie nicht als Teil einer Kopieranfrage angegeben wird, erbt die Datei alle ermittelbaren ü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.
`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.
`openWithLinks`	`map (key: string, value: string)` Nur Ausgabe. Eine Zuordnung der ID jeder der Apps des Nutzers zu einem Link zum Öffnen dieser Datei mit der jeweiligen App. Wird nur ausgefüllt, wenn der Bereich „drive.apps.readonly“ verwendet wird. Ein Objekt, das eine Liste von `"key": value`-Paaren enthält. Beispiel: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`properties[]`	`object (Property)` Die Liste der Properties.
`permissions[]`	`object (Permission)` Nur Ausgabe. Die Liste der Berechtigungen für Nutzer mit Zugriff auf diese Datei. Für Elemente in geteilten Ablagen nicht ausgefüllt.
`spaces[]`	`string` Nur Ausgabe. Die Liste der Bereiche, die die Datei enthalten. Unterstützte Werte sind `drive`, `appDataFolder` und `photos`.
`permissionIds[]`	`string` Nur Ausgabe. files.list 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. 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 nachfolgendem Text, der nicht Teil der Erweiterung zu sein scheint, wurde entfernt. Dieses Feld wird nur für Dateien mit Inhalten in Google Drive ausgefüllt, nicht für Dateien aus den Docs-Editoren oder Verknüpfungsdateien.
`md5Checksum`	`string` Nur Ausgabe. Eine MD5-Prüfsumme für den Inhalt dieser Datei. Dieses Feld wird nur für Dateien mit Inhalten in Google Drive ausgefüllt, nicht für Dateien aus den Docs-Editoren oder Verknüpfungsdateien.
`selfLink`	`string` Nur Ausgabe. Ein Link zurück zu dieser Datei.
`lastModifyingUserName`	`string` Nur Ausgabe. Name des Nutzers, der diese Datei zuletzt geändert hat.
`editable (deprecated)`	`boolean` Dieses Element ist veraltet. Nur Ausgabe. Verworfen: Verwenden Sie stattdessen `capabilities/canEdit`.
`writersCanShare`	`boolean` Ob Autoren das Dokument für andere Nutzer freigeben können. 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 in Google Drive ausgefüllt, nicht für Google-Dokumente oder Verknüpfungsdateien.
`mimeType`	`string` Der MIME-Typ der Datei. Dieser Wert kann nur beim Hochladen neuer Inhalte geändert werden. Dieses Feld kann leer gelassen werden. Der MIME-Typ wird dann anhand des MIME-Typs des hochgeladenen Inhalts 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.
`thumbnailLink`	`string` Nur Ausgabe. Ein kurzlebiger Link zur Miniaturansicht der Datei, falls verfügbar. Die Dauer beträgt in der Regel einige Stunden. Aufgrund von Cross-Origin Resource Sharing (CORS) ist die direkte Verwendung in Webanwendungen nicht vorgesehen. Verwenden Sie stattdessen einen Proxyserver. Wird nur ausgefüllt, wenn die anfragende App auf den Inhalt der Datei zugreifen kann. Wenn die Datei nicht öffentlich freigegeben ist, muss die in `Files.thumbnailLink` zurückgegebene URL mit einer Anfrage mit Anmeldedaten abgerufen werden.
`appDataContents`	`boolean` Nur Ausgabe. Gibt an, ob sich diese Datei im Ordner „Anwendungsdaten“ befindet.
`webViewLink`	`string` Nur Ausgabe. Ein Link, der nur in öffentlichen Ordnern verfügbar ist, damit die statischen Web-Assets (HTML, CSS, JS usw.) über das Website-Hosting von Google Drive aufgerufen werden können.
`iconLink`	`string` Nur Ausgabe. Ein Link zum Symbol der Datei.
`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 diese Datei geändert hat. Dieses Feld wird nur ausgefüllt, wenn die letzte Änderung von einem angemeldeten Nutzer vorgenommen wurde.
`defaultOpenWithLink`	`string` Nur Ausgabe. Ein Link zum Öffnen dieser Datei mit der Standard-App des Nutzers für diese Datei. Wird nur ausgefüllt, wenn der Bereich „drive.apps.readonly“ verwendet wird.
`headRevisionId`	`string` Nur Ausgabe. Die ID der Head-Revision der Datei. Dieses Feld wird nur für Dateien mit Inhalten in Google Drive ausgefüllt, nicht für Dateien aus den Docs-Editoren oder Verknüpfungsdateien.
`copyable (deprecated)`	`boolean` Dieses Element ist veraltet. 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, falls verfügbar.
`alternateLink`	`string` Nur Ausgabe. Ein Link zum Öffnen der Datei in einem entsprechenden Google-Editor oder ‑Viewer.
`embedLink`	`string` Nur Ausgabe. Ein Link zum Einbetten der Datei.
`webContentLink`	`string` Nur Ausgabe. Ein Link zum Herunterladen des Inhalts der Datei in einem Browser mithilfe der cookiebasierten Authentifizierung. Wenn die Inhalte öffentlich geteilt werden, können sie ohne Anmeldedaten heruntergeladen werden.
`fileSize`	`string (int64 format)` Nur Ausgabe. Größe von Blobs und Dateien des Erstanbieter-Editors in Byte. Wird für Dateien ohne Größe, z. B. Verknüpfungen und Ordner, nicht ausgefüllt.
`copyRequiresWriterPermission`	`boolean` Gibt an, ob die Optionen zum Kopieren, Drucken oder Herunterladen dieser Datei für Leser und Kommentatoren deaktiviert werden sollen.
`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 Ordnerfarbe als RGB-Hex-String, wenn die Datei ein Ordner oder eine Verknüpfung zu einem Ordner ist. Die Liste der unterstützten Farben ist im Feld „folderColorPalette“ der Ressource „About“ verfügbar. Wenn eine nicht unterstützte Farbe angegeben wird, wird sie in die nächstgelegene Farbe in der Palette geändert.
`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 Stammordner 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 Sternchen markiert wurde.
`labels.hidden (deprecated)`	`boolean` Nur Ausgabe. Verworfen.
`labels.trashed`	`boolean` Gibt an, ob diese Datei im Papierkorb ist. Dieses Label wird für alle Nutzer angezeigt, die auf die Datei zugreifen. Nur Eigentümer dürfen Dateien ansehen und aus dem Papierkorb entfernen.
`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. Erstellungszeit für diese Datei (formatierter RFC 3339-Zeitstempel).
`modifiedDate`	`string` Der Zeitpunkt, zu dem diese Datei zuletzt von jemandem geändert wurde (als RFC 3339-Zeitstempel formatiert). Dieser Wert kann nur bei der Aktualisierung geändert werden, wenn der Parameter „setModifiedDate“ festgelegt ist.
`modifiedByMeDate`	`string` Nur Ausgabe. Zeitpunkt der letzten Änderung dieser Datei durch den Nutzer (formatiert als RFC 3339-Zeitstempel). Wenn Sie „modifiedDate“ festlegen, wird auch das Datum „modifiedByMe“ für den Nutzer aktualisiert, der das Datum festgelegt hat.
`lastViewedByMeDate`	`string` Zeitstempel (RFC 3339-Format), wann die Datei zuletzt vom Nutzer aufgerufen wurde.
`markedViewedByMeDate (deprecated)`	`string` Dieses Element ist veraltet. Nur Ausgabe. Verworfen.
`sharedWithMeDate`	`string` Nur Ausgabe. 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 steigende 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 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ärem Inhalt in Google Drive verfügbar.
`ownedByMe`	`boolean` Nur Ausgabe. Gibt an, ob die Datei dem aktuellen Nutzer gehört. Für Elemente in geteilten Ablagen nicht ausgefüllt.
`canComment (deprecated)`	`boolean` Dieses Element ist veraltet. Nur Ausgabe. Verworfen: Verwenden Sie stattdessen `capabilities/canComment`.
`shareable (deprecated)`	`boolean` Dieses Element ist veraltet. Nur Ausgabe. Verworfen: Verwenden Sie stattdessen `capabilities/canShare`.
`fullFileExtension`	`string` Nur Ausgabe. Die vollständige Dateiendung, die aus dem Titel extrahiert wurde. Kann mehrere verkettete Erweiterungen enthalten, z. B. „tar.gz“. Wenn Sie eine Erweiterung aus dem Titel entfernen, wird dieses Feld nicht geleert. Wenn Sie die Erweiterung im Titel ändern, wird dieses Feld jedoch aktualisiert. Dieses Feld wird nur für Dateien mit Inhalten in Google Drive ausgefüllt, nicht für Dateien aus den Docs-Editoren oder Verknüpfungsdateien.
`isAppAuthorized`	`boolean` Nur Ausgabe. Gibt an, ob die Datei von der anfragenden App erstellt oder geöffnet wurde.
`teamDriveId (deprecated)`	`string` Dieses Element ist veraltet. Nur Ausgabe. Verworfen: 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.
`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. „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 für ein Element in einer geteilten Ablage 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. Dieser Wert ist immer „false“, 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 „false“, 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 „false“, 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 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` 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. „false“, 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. „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 je nach dem neuen übergeordneten Element, das hinzugefügt wird, weiterhin 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 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 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. „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. „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 Inhaber-beschränkte Inhaltsbeschränkungen hinzufügen oder ändern kann.
`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` 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. Gibt an, ob für diese Datei Berechtigungen festgelegt 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.
`canReadRevisions (deprecated)`	`boolean` Dieses Element ist veraltet. 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 das Element in den Papierkorb verschoben wurde (als RFC 3339-Zeitstempel formatiert). Wird nur für Elemente in geteilten Ablagen ausgefüllt.
`thumbnail`	`object` Eine Miniaturansicht der Datei. Diese wird nur verwendet, wenn kein Standard-Thumbnail generiert werden kann.
`thumbnail.image`	`string (bytes format)` Die URL-sicheren Base64-codierten Bytes des Bildes für die Miniaturansicht. 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. Diese Informationen sind nur für Bildtypen verfügbar und hängen davon ab, was aus dem Bildinhalt geparst werden kann.
`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.date`	`string` Nur Ausgabe. Datum und Uhrzeit der Aufnahme des Fotos (EXIF-Zeitstempel).
`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. 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 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 Felds ist ein Snapshot des MIME-Typs des Ziels, der beim Erstellen der Verknüpfung aufgenommen wurde.
`shortcutDetails.targetResourceKey`	`string` Nur Ausgabe. Der 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`	`object` Nur Ausgabe. LinkShare-bezogene Details Enthält Details zu den Link-URLs, die Clients verwenden, um auf dieses Element zu verweisen.
`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 werden. 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 in Google Drive ausgefüllt, nicht für Dateien aus den Docs-Editoren oder Verknüpfungsdateien.
`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 in Google Drive ausgefüllt, nicht für Dateien aus den Docs-Editoren oder Verknüpfungsdateien.
`inheritedPermissionsDisabled`	`boolean` Gibt an, ob für diese Datei die Übernahme von Berechtigungen deaktiviert ist. Ü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 des Inhalts der Datei. Dieser Wert kann nur bei Anfragen geändert werden, bei 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“ 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` 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 Inhalte ändern oder entfernen, die vom System eingeschränkt wurden.

Methoden
`copy`	Erstellt eine Kopie der angegebenen Datei.
`delete`	Löscht eine Datei, die dem Nutzer gehört, endgültig, ohne sie in den Papierkorb zu verschieben.
`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 Einfüge- oder Kopieranfragen angegeben werden können.
`get`	Ruft Metadaten oder Inhalte einer Datei anhand der ID ab.
`insert`	Fügt eine neue Datei ein.
`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.
`patch`	Aktualisiert die Metadaten und/oder den Inhalt einer Datei.
`touch`	Legen Sie die aktualisierte Zeit 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.

REST Resource: files

Ressource: Datei

ContentRestriction

Methoden

`copy`

`delete`

`emptyTrash`

`export`

`generateIds`

`get`

`insert`

`list`

`listLabels`

`modifyLabels`

`patch`

`touch`

`trash`

`untrash`

`update`

`watch`

REST Resource: files Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Ressource: Datei

ContentRestriction

Methoden

REST Resource: files