REST Resource: files

Ressource: Datei

Die Metadaten für eine Datei.

Für einige Ressourcenmethoden wie files.update ist ein fileId erforderlich. Verwenden Sie die Methode files.list, um die ID für eine Datei abzurufen.

JSON-Darstellung
{
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "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,
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "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
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "permissionIds": [
    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,
    "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
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string
}
Felder
kind

string

Nur Ausgabe. Gibt an, um welche Art von Ressource es sich handelt. Wert: fester 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ären Inhalten in Google Drive verfügbar.

copyRequiresWriterPermission

boolean

Sollen die Optionen zum Kopieren, Drucken oder Herunterladen dieser Datei für Leser und Kommentatoren deaktiviert werden?

md5Checksum

string

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

contentHints

object

Zusätzliche Informationen zum Inhalt der Datei. Diese Felder werden nie in Antworten eingefügt.

contentHints.indexableText

string

Zu indexierender Text für die Datei zur Verbesserung von FullText-Abfragen Er ist auf 128 KB begrenzt und kann HTML-Elemente enthalten.

contentHints.thumbnail

object

Eine Miniaturansicht für die Datei. Diese Option wird nur verwendet, wenn in Google Drive keine standardmäßige Miniaturansicht generiert werden kann.

contentHints.thumbnail.image

string (bytes format)

Die Miniaturansicht-Daten, die mit URL-sicherem Base64 (RFC 4648, Abschnitt 5) codiert sind.

Ein base64-codierter String.

contentHints.thumbnail.mimeType

string

Der MIME-Typ des Thumbnails.

writersCanShare

boolean

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

viewedByMe

boolean

Nur Ausgabe. Gibt an, ob der Nutzer die Datei aufgerufen hat.

mimeType

string

Der MIME-Typ der Datei.

Wenn kein Wert angegeben ist, versucht Google Drive, automatisch einen geeigneten Wert aus hochgeladenen Inhalten zu ermitteln. Der Wert kann nur geändert werden, wenn eine neue Überarbeitung hochgeladen wurde.

Wenn eine Datei mit dem MIME-Typ „Google Docs“ erstellt wird, werden die hochgeladenen Inhalte nach Möglichkeit importiert. Die unterstützten Importformate werden in der Ressource „Info“ veröffentlicht.

parents[]

string

Die IDs der übergeordneten Ordner, die die Datei enthalten.

Falls sie nicht beim Erstellen einer Anfrage angegeben ist, wird die Datei direkt im Ordner „Meine Ablage“ des Nutzers abgelegt. Falls sie nicht als Teil einer Kopieranfrage angegeben ist, übernimmt die Datei alle auffindbaren übergeordneten Elemente der Quelldatei. Files.update-Anfragen müssen die Parameter addParents und removeParents verwenden, um die übergeordnete Liste zu ändern.

shared

boolean

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

lastModifyingUser

object (User)

Nur Ausgabe. Der letzte Nutzer, der die Datei geändert hat.

owners[]

object (User)

Nur Ausgabe. Der Eigentümer dieser Datei. Nur bestimmte alte Dateien dürfen mehr als einen Eigentümer haben. Das Feld wird für Elemente in geteilten Ablagen nicht ausgefüllt.

headRevisionId

string

Nur Ausgabe. Die ID der Head-Überarbeitung 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)

size

string (int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

Eingestellt: Verwenden Sie stattdessen copyRequiresWriterPermission.

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. Wird für Elemente in geteilten Ablagen nicht ausgefüllt.

hasThumbnail

boolean

Nur Ausgabe. Gibt an, ob diese Datei eine Miniaturansicht hat. Dies bedeutet nicht, dass die anfragende App Zugriff auf das Thumbnail hat. Wenn Sie prüfen möchten, ob der Zugriff möglich ist, suchen Sie nach dem Feld „thumbnailLink“.

spaces[]

string

Nur Ausgabe. Die Liste der Gruppenbereiche, die die Datei enthalten. Derzeit werden die Werte „drive“, „appDataFolder“ und „photos“ unterstützt.

folderColorRgb

string

Die Farbe eines Ordners oder eine Verknüpfung zu einem Ordner als hexadezimaler RGB-String. Die unterstützten Farben werden im Feld folderColorPalette der Ressource „Info“ veröffentlicht.

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

id

string

Die ID der Datei.

name

string

Der Name der Datei. Innerhalb eines Ordners ist das nicht zwangsläufig eindeutig. Hinweis: Unveränderliche Elemente wie die Ordner der obersten Ebene geteilter Ablagen, der Stammordner von „Meine Ablage“ und der Ordner „Anwendungsdaten“ sind unveränderlich.

description

string

Eine kurze Beschreibung der Datei.

starred

boolean

Gibt an, ob der Nutzer die Datei markiert hat.

trashed

boolean

Gibt an, ob die Datei explizit oder aus einem Papierkorb in den Papierkorb verschoben wurde. Nur der Eigentümer darf eine Datei in den Papierkorb verschieben und andere Nutzer können die Dateien nicht im Papierkorb des Eigentümers sehen.

explicitlyTrashed

boolean

Nur Ausgabe. Gibt an, ob die Datei explizit in den Papierkorb verschoben wurde (statt rekursiv in einen übergeordneten Ordner).

createdTime

string

Der Zeitpunkt, zu dem die Datei erstellt wurde (RFC 3339 Datum/Uhrzeit).

modifiedTime

string

Der Zeitpunkt der letzten Änderung (durch die RFC 3339-Datums- und Uhrzeitangabe).

Hinweis: Durch das Festlegen von modifiedTime wird auch modifiedByMeTime für den Nutzer aktualisiert.

modifiedByMeTime

string

Nur Ausgabe. Der Zeitpunkt der letzten Änderung der Datei durch den Nutzer (Datum/Uhrzeit gemäß RFC 3339).

viewedByMeTime

string

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

sharedWithMeTime

string

Nur Ausgabe. Der Zeitpunkt, zu dem die Datei für den Nutzer freigegeben wurde, sofern zutreffend (RFC 3339 Datum/Uhrzeit).

quotaBytesUsed

string (int64 format)

Nur Ausgabe. Die Anzahl der von der Datei verwendeten Speicherkontingentbyte. Dazu gehören die Head-Überarbeitung sowie vorherige Überarbeitungen mit aktivierter keepForever.

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 Nutzer nicht sichtbar sind.

originalFilename

string

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

ownedByMe

boolean

Nur Ausgabe. Ob der Nutzer Eigentümer der Datei ist Wird 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 wie „tar.gz“ enthalten. Diese Funktion ist nur für Dateien mit binären Inhalten in Google Drive verfügbar.

Dies 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.

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 der anfragenden App privat sind

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

Diese Attribute können nur mit einer authentifizierten Anfrage abgerufen werden. Bei einer authentifizierten Anfrage wird ein Zugriffstoken mit einer OAuth 2-Client-ID verwendet. API-Schlüssel können nicht zum Abrufen privater Properties verwendet werden.

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

isAppAuthorized

boolean

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

teamDriveId
(deprecated)

string

Verworfen: Nur Ausgabe. Verwenden Sie stattdessen driveId.

capabilities

object

Nur Ausgabe. Die Berechtigungen des aktuellen Nutzers für diese Datei. Jede Funktion entspricht einer detaillierten Aktion, die ein Nutzer ausführen kann.

capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

Verworfen: Nur Ausgabe.

capabilities.canMoveChildrenOutOfDrive

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners aus der geteilten Ablage verschieben kann. Das 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 darf. Andere Faktoren können die Art der Änderungen einschränken, die Nutzer an einer Datei vornehmen können. 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 bei einem Element in einer geteilten Ablage Nicht-Ordner-Nachfolgerelemente dieses Elements oder dieses Element selbst kopieren kann, wenn es sich dabei nicht um einen Ordner handelt.

capabilities.canComment

boolean

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

capabilities.canAddChildren

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer diesem Ordner Kinder hinzufügen kann. Das 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 Ordner auflisten darf. Das ist immer „false“, wenn das Element kein Ordner ist.

capabilities.canRemoveChildren

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer Kinder aus diesem Ordner entfernen kann. Das ist immer „false“, wenn das Element kein Ordner ist. Verwenden Sie stattdessen canDeleteChildren oder canTrashChildren für einen Ordner in einer geteilten Ablage.

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 Überarbeitungsressource dieser Datei lesen kann. Gibt an, ob für ein Element in einer geteilten Ablage Lesevorgänge für Nachfolgeelemente dieses Ordners oder für Elemente, die kein Ordner sind, gelesen werden kann.

capabilities.canReadTeamDrive
(deprecated)

boolean

Verworfen: Nur Ausgabe. Verwenden Sie stattdessen canReadDrive.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Verworfen: 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

Verworfen: 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 darf.

capabilities.canMoveItemWithinTeamDrive
(deprecated)

boolean

Verworfen: Nur Ausgabe. Verwenden Sie stattdessen canMoveItemWithinDrive.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Verworfen: Nur Ausgabe. Verwenden Sie stattdessen canMoveItemOutOfDrive.

capabilities.canDeleteChildren

boolean

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

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

Verworfen: Nur Ausgabe. Verwenden Sie stattdessen canMoveChildrenOutOfDrive.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Verworfen: 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 darf. Das 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 außerhalb dieser Ablage verschieben kann, indem er das übergeordnete Element ändert. Beachten Sie, dass eine Anfrage zum Ändern des übergeordneten Elements des Elements weiterhin fehlschlagen kann, 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 in der Anfrage ein vorhandenes übergeordnetes Element zu entfernen. Wird 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 weiteres übergeordnetes Element hinzuzufügen. Wird 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. Beachten Sie, dass eine Anfrage zur Änderung des übergeordneten Elements weiterhin fehlgeschlagen sein kann. Das hängt vom neuen Element ab, das hinzugefügt wird, und vom übergeordneten Element, das entfernt wird.

capabilities.canShare

boolean

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

capabilities.canMoveChildrenWithinDrive

boolean

Nur Ausgabe. Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners in dieser Ablage verschieben kann. Das ist „false“, wenn das Element kein Ordner ist. Beachten Sie, dass eine Anfrage zum Verschieben des untergeordneten Elements weiterhin fehlschlägt. Das hängt vom Zugriff des aktuellen Nutzers auf das untergeordnete Element und auf den Zielordner ab.

capabilities.canModifyContentRestriction
(deprecated)

boolean

Verworfen: 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 Ablage (andere geteilte Ablage oder „Meine Ablage“) hinzufügen kann. Das 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“ bei Metadaten zur Linkfreigabe ändern kann.

capabilities.canAcceptOwnership

boolean

Nur Ausgabe. Ob der aktuelle Nutzer der ausstehende Eigentümer der Datei ist. Wird für Dateien in geteilten Ablagen nicht ausgefüllt.

capabilities.canReadLabels

boolean

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

capabilities.canModifyLabels

boolean

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

capabilities.canModifyEditorContentRestriction

boolean

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

capabilities.canModifyOwnerContentRestriction

boolean

Nur Ausgabe. 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 die Datei Inhaltsbeschränkungen enthält, die vom aktuellen Nutzer entfernt werden können.

hasAugmentedPermissions

boolean

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

trashingUser

object (User)

Nur Ausgabe. Wenn die Datei explizit in den Papierkorb verschoben wurde, hat der Nutzer sie gelöscht. Wird nur für Elemente in geteilten Ablagen ausgefüllt.

thumbnailVersion

string (int64 format)

Nur Ausgabe. Die Miniaturansicht-Version, die bei der Entwertung von Miniaturansicht-Caches verwendet wird.

trashedTime

string

Nur Ausgabe. Die Zeit, in der das Element in den Papierkorb verschoben wurde (Datum/Uhrzeit gemäß RFC 3339). 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.

permissionIds[]

string

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

imageMediaMetadata

object

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

imageMediaMetadata.flashUsed

boolean

Nur Ausgabe. Gibt an, ob zum Erstellen des Fotos ein Blitz verwendet wurde.

imageMediaMetadata.meteringMode

string

Nur Ausgabe. Der beim Erstellen des Fotos verwendete Messmodus

imageMediaMetadata.sensor

string

Nur Ausgabe. Die Art des Sensors, der für die Erstellung des Fotos verwendet wurde.

imageMediaMetadata.exposureMode

string

Nur Ausgabe. Belichtungsmodus, mit dem das Foto erstellt wurde

imageMediaMetadata.colorSpace

string

Nur Ausgabe. Der Farbraum des Fotos.

imageMediaMetadata.whiteBalance

string

Nur Ausgabe. Der Weißabgleichmodus, der für die Erstellung 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 von der ursprünglichen Ausrichtung des Bildes.

imageMediaMetadata.time

string

Nur Ausgabe. Datum und Uhrzeit der Fotoaufnahme (EXIF DateTime)

imageMediaMetadata.cameraMake

string

Nur Ausgabe. Auf der Kamera, mit der das Foto erstellt wurde

imageMediaMetadata.cameraModel

string

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

imageMediaMetadata.exposureTime

number

Nur Ausgabe. Die Länge der Belichtung in Sekunden.

imageMediaMetadata.aperture

number

Nur Ausgabe. Die zum Erstellen des Fotos verwendete Blende (f-Zahl).

imageMediaMetadata.focalLength

number

Nur Ausgabe. Die für die Erstellung des Fotos erforderliche Brennweite in Millimetern.

imageMediaMetadata.isoSpeed

integer

Nur Ausgabe. Die ISO-Geschwindigkeit für die Erstellung des Fotos.

imageMediaMetadata.exposureBias

number

Nur Ausgabe. Belichtungsverzerrung des Fotos (APEX-Wert).

imageMediaMetadata.maxApertureValue

number

Nur Ausgabe. Die kleinste f-Zahl des Objektivs in der Brennweite, die für die Erstellung 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 erstellt wurde

videoMediaMetadata

object

Nur Ausgabe. Zusätzliche Metadaten zu Videomedien. Diese sind nach dem Upload möglicherweise nicht sofort verfügbar.

videoMediaMetadata.width

integer

Nur Ausgabe. Breite des Videos in Pixeln

videoMediaMetadata.height

integer

Nur Ausgabe. 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, in denen das Feld „mimeType“ auf application/vnd.google-apps.shortcut gesetzt ist.

shortcutDetails.targetId

string

Die ID der Datei, auf die diese Verknüpfung verweist.

shortcutDetails.targetMimeType

string

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

shortcutDetails.targetResourceKey

string

Nur Ausgabe. Der ResourceKey für die Zieldatei.

contentRestrictions[]

object (ContentRestriction)

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

resourceKey

string

Nur Ausgabe. Einen Schlüssel für den Zugriff auf das Element über einen freigegebenen Link.

linkShareMetadata.securityUpdateEligible

boolean

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

linkShareMetadata.securityUpdateEnabled

boolean

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

labelInfo

object

Nur Ausgabe. Eine Übersicht der Labels der Datei.

labelInfo.labels[]

object (Label)

Nur Ausgabe. Der Labelsatz in der Datei, wie von den Label-IDs im Parameter includeLabels angefordert. Standardmäßig werden keine Labels zurückgegeben.

sha1Checksum

string

Nur Ausgabe. Die mit dieser Datei verknüpfte SHA1-Prüfsumme, falls verfügbar. Dieses Feld wird nur für Dateien mit in Google Drive gespeicherten Inhalten ausgefüllt. Für Docs-Editoren oder Verknüpfungsdateien ist es nicht ausgefüllt.

sha256Checksum

string

Nur Ausgabe. Die mit dieser Datei verknüpfte SHA256-Prüfsumme, falls verfügbar. Dieses Feld wird nur für Dateien mit in Google Drive gespeicherten Inhalten ausgefüllt. Für Docs-Editoren oder Verknüpfungsdateien ist es nicht ausgefüllt.

Inhaltsbeschränkung

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
}
Felder
readOnly

boolean

Gibt an, ob der Inhalt der Datei schreibgeschützt ist. Ist eine Datei schreibgeschützt, werden unter Umständen keine neuen Überarbeitungen hinzugefügt und keine Kommentare hinzugefügt oder geändert. Auch der Titel der Datei kann nicht geändert werden.

reason

string

Grund für die Beschränkung des Inhalts der Datei. Dies ist nur bei Anfragen möglich, die auch readOnly=true festlegen.

type

string

Nur Ausgabe. Der Typ der Inhaltseinschränkung. Der einzig mögliche Wert ist globalContentRestriction.

restrictingUser

object (User)

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

restrictionTime

string

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

ownerRestricted

boolean

Ob die Inhaltsbeschränkung nur von einem Nutzer, dem die Datei gehört, bearbeitet oder entfernt werden kann. Bei Dateien in geteilten Ablagen kann jeder Nutzer mit der Berechtigung organizer diese Inhaltsbeschränkung ändern oder entfernen.

Methoden

copy

Erstellt eine Kopie einer Datei und wendet alle angeforderten Aktualisierungen mit Patchsemantik an.

create

Erstellt eine neue Datei.

delete

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

emptyTrash

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

export

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

generateIds

Erstellt eine Reihe von Datei-IDs, die in Erstellungs- oder Kopieranfragen zur Verfügung gestellt werden können

get

Ruft die Metadaten oder Inhalte einer Datei nach ID ab

list

Listet die Dateien des Nutzers auf.

listLabels

Listet die Labels einer Datei auf.

modifyLabels

Damit wird der Satz von Labels geändert, die auf eine Datei angewendet werden.

update

Aktualisiert die Metadaten und/oder Inhalte der Datei.

watch

Abonnieren von Änderungen an einer Datei