REST Resource: files

Ressource: Datei

Die Metadaten für eine Datei.

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

JSON-Darstellung
{
  "kind": string,
  "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, 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 Option ist nur für Dateien mit binären Inhalten in Google Drive verfügbar.

copyRequiresWriterPermission

boolean

Legt fest, 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. 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 in Antworten nie ausgefüllt.

contentHints.indexableText

string

Text, der für die Datei indexiert werden soll, um FullText-Abfragen zu verbessern. Diese Datei ist auf 128 KB beschränkt und kann HTML-Elemente enthalten.

contentHints.thumbnail

object

Eine Miniaturansicht für die Datei. Diese Option wird nur verwendet, wenn Google Drive keine Standard-Miniaturansicht generieren kann.

contentHints.thumbnail.image

string (bytes format)

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

Ein base64-codierter String.

contentHints.thumbnail.mimeType

string

Der MIME-Typ der Miniaturansicht.

writersCanShare

boolean

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

viewedByMe

boolean

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

mimeType

string

Der MIME-Typ der Datei.

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

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.

Wenn die Datei nicht bei der Erstellungsanfrage angegeben ist, wird sie direkt im Ordner „Meine Ablage“ des Nutzers abgelegt. Wenn die Datei nicht als Teil einer Kopieranfrage angegeben wird, übernimmt die Datei alle sichtbaren übergeordneten Elemente der Quelldatei. In „files.update“-Anfragen müssen die Parameter addParents und removeParents verwendet werden, um die Liste der übergeordneten Elemente 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 können mehrere Eigentümer haben. Dieses Feld wird für Elemente in geteilten Ablagen nicht ausgefüllt.

headRevisionId

string

Nur Ausgabe Die ID der Hauptüberarbeitung der Datei. Diese Option 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, sofern zutreffend.

size

string (int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

Eingestellt: Verwende stattdessen copyRequiresWriterPermission.

permissions[]

object (Permission)

Nur Ausgabe Die vollständige Liste der Berechtigungen für die Datei. Dies 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, ob die anfragende App Zugriff auf die Miniaturansicht hat. Wenn Sie den Zugriff prüfen möchten, achten Sie darauf, dass das Feld „thumbnailLink“ vorhanden ist.

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 einer Verknüpfung zu einem Ordner als hexadezimaler RGB-String. Die unterstützten Farben werden im Feld folderColorPalette der Ressource „Info“ veröffentlicht.

Wenn eine nicht unterstützte Farbe angegeben wird, wird stattdessen die am besten passende Farbe aus der Palette verwendet.

id

string

Die ID der Datei.

name

string

Der Name der Datei. Er ist innerhalb eines Ordners nicht unbedingt eindeutig. Hinweis: Bei unveränderlichen Elementen wie Ordnern der obersten Ebene von geteilten Ablagen, dem Stammordner „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 markiert hat.

trashed

boolean

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

explicitlyTrashed

boolean

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

createdTime

string

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

modifiedTime

string

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

Durch die Einstellung „modifiedTime“ wird auch modifiedByMeTime für den Nutzer aktualisiert.

modifiedByMeTime

string

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

viewedByMeTime

string

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

sharedWithMeTime

string

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

quotaBytesUsed

string (int64 format)

Nur Ausgabe Die Anzahl der von der Datei genutzten Speicherkontingent-Byte. Dazu gehören die Head-Revision sowie vorherige Überarbeitungen mit aktiviertem keepForever.

version

string (int64 format)

Nur Ausgabe Eine kontinuierlich ansteigende Versionsnummer für die Datei. Dies berücksichtigt jede Änderung, die auf dem Server an der Datei vorgenommen wurde, 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 Option ist nur für Dateien mit binären Inhalten in Google Drive verfügbar.

ownedByMe

boolean

Nur Ausgabe Gibt an, 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 enthalten, z. B. „tar.gz“. Diese Option ist nur für Dateien mit binären Inhalten in Google Drive verfügbar.

Sie 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 nur für die anfragende Anwendung zugänglich sind.

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

Diese Attribute können nur mit einer authentifizierten Anfrage abgerufen werden. Eine authentifizierte Anfrage verwendet ein Zugriffstoken, das mit einer OAuth 2-Client-ID abgerufen wurde. Sie können keinen API-Schlüssel verwenden, um private Attribute abzurufen.

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

Eingestellt: Nur Ausgabe. Verwenden Sie stattdessen driveId.

capabilities

object

Nur Ausgabe Berechtigungen, die der aktuelle Nutzer für diese Datei hat. Jede Funktion entspricht einer detaillierten Aktion, die ein Nutzer ausführen kann.

capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

Eingestellt: Nur Ausgabe.

capabilities.canMoveChildrenOutOfDrive

boolean

Nur Ausgabe Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners aus der geteilten Ablage verschieben kann. Der Wert 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: canChangeCopyRequiresWriterPermission oder canModifyContent.

capabilities.canCopy

boolean

Nur Ausgabe Gibt an, ob der aktuelle Nutzer diese Datei kopieren kann. Gibt an, ob der aktuelle Nutzer für ein Element in einer geteilten Ablage untergeordnete Elemente dieses Elements kopieren kann, die nicht aus einem Ordner stammen, oder dieses Element selbst, 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 Kinder 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 Überarbeitungsressource dieser Datei lesen kann. Gibt an, ob bei einem Element in einer geteilten Ablage Überarbeitungen von untergeordneten Elementen dieses Elements, die nicht zum Ordner gehören, oder des Elements selbst, falls es kein Ordner ist, gelesen werden können.

capabilities.canReadTeamDrive
(deprecated)

boolean

Eingestellt: Nur Ausgabe. Verwenden Sie stattdessen canReadDrive.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Eingestellt: Nur Ausgabe. Verwende stattdessen canMoveItemWithinDrive oder canMoveItemOutOfDrive.

capabilities.canChangeCopyRequiresWriterPermission

boolean

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

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

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

Eingestellt: Nur Ausgabe. Verwenden Sie stattdessen canMoveItemWithinDrive.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Eingestellt: Nur Ausgabe. Verwenden Sie stattdessen canMoveItemOutOfDrive.

capabilities.canDeleteChildren

boolean

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

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

Eingestellt: Nur Ausgabe. Verwenden Sie stattdessen canMoveChildrenOutOfDrive.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Eingestellt: 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. Der Wert 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 das übergeordnete Element ändert. Beachten Sie, dass eine Anfrage zum Ändern des übergeordneten Elements des Elements auch dann fehlschlagen kann, wenn das neue übergeordnete Element hinzugefügt wird.

capabilities.canAddMyDriveParent

boolean

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

capabilities.canRemoveMyDriveParent

boolean

Nur Ausgabe Gibt an, ob der aktuelle Nutzer einen übergeordneten Nutzer aus dem Artikel entfernen kann, ohne in derselben Anfrage einen weiteren übergeordneten Nutzer hinzuzufügen. Wird für Dateien in geteilten Ablagen nicht ausgefüllt.

capabilities.canMoveItemWithinDrive

boolean

Nur Ausgabe Gibt an, ob der aktuelle Nutzer das Element innerhalb dieser Ablage verschieben kann. Beachten Sie, dass eine Anfrage zum Ändern des übergeordneten Elements weiterhin fehlschlagen kann, je nachdem, welches neue übergeordnete Element hinzugefügt wird und welches übergeordnete Element 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. Der Wert ist „false“, wenn das Element kein Ordner ist. Beachten Sie, dass eine Anfrage zum Verschieben der untergeordneten Datei weiterhin fehlschlagen kann, je nachdem, ob der aktuelle Nutzer Zugriff auf die untergeordnete Organisation und den Zielordner hat.

capabilities.canModifyContentRestriction
(deprecated)

boolean

Eingestellt: Nur Ausgabe. Verwenden Sie canModifyEditorContentRestriction, canModifyOwnerContentRestriction oder canRemoveContentRestriction.

capabilities.canAddFolderFromAnotherDrive

boolean

Nur Ausgabe Gibt an, ob der aktuelle Nutzer diesem Ordner einen Ordner aus einer anderen geteilten Ablage oder aus „Meine Ablage“ hinzufügen kann. Der Wert 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 Metadaten zur Linkfreigabe ändern kann.

capabilities.canAcceptOwnership

boolean

Nur Ausgabe Gibt an, 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 in der Datei lesen kann.

capabilities.canModifyLabels

boolean

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

capabilities.canModifyEditorContentRestriction

boolean

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

capabilities.canModifyOwnerContentRestriction

boolean

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

capabilities.canRemoveContentRestriction

boolean

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

hasAugmentedPermissions

boolean

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

trashingUser

object (User)

Nur Ausgabe Wenn die Datei explizit in den Papierkorb verschoben wurde, ist 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 zur Verwendung bei der Thumbnail-Cache-Entwertung.

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.

permissionIds[]

string

Nur Ausgabe. files.list mit 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 Angabe, ob zum Erstellen des Fotos ein Blitz verwendet wurde

imageMediaMetadata.meteringMode

string

Nur Ausgabe Der Messmodus, mit dem das Foto erstellt wurde.

imageMediaMetadata.sensor

string

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

imageMediaMetadata.exposureMode

string

Nur Ausgabe Der zum Erstellen des Fotos verwendete Belichtungsmodus.

imageMediaMetadata.colorSpace

string

Nur Ausgabe Der Farbraum des Fotos.

imageMediaMetadata.whiteBalance

string

Nur Ausgabe Der Weißabgleichmodus, mit dem das Foto erstellt 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 Geografische Standortinformationen, die im Bild gespeichert sind.

imageMediaMetadata.location.latitude

number

Nur Ausgabe Der im Bild gespeicherte Breitengrad.

imageMediaMetadata.location.longitude

number

Nur Ausgabe Der im Bild gespeicherte Längengrad.

imageMediaMetadata.location.altitude

number

Nur Ausgabe Die im Bild gespeicherte Höhe.

imageMediaMetadata.rotation

integer

Nur Ausgabe Anzahl der 90-Grad-Drehungen im Uhrzeigersinn, die ausgehend von der ursprünglichen 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 Dauer der Belichtung in Sekunden.

imageMediaMetadata.aperture

number

Nur Ausgabe Die Blende, mit der das Foto erstellt wurde (Blendenzahl).

imageMediaMetadata.focalLength

number

Nur Ausgabe Die Brennweite in Millimeter, die zum Erstellen des Fotos verwendet wurde.

imageMediaMetadata.isoSpeed

integer

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

imageMediaMetadata.exposureBias

number

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

imageMediaMetadata.maxApertureValue

number

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

imageMediaMetadata.subjectDistance

integer

Nur Ausgabe Der Abstand zum Motiv des Fotos in Metern.

imageMediaMetadata.lens

string

Nur Ausgabe Die Linse, mit der das Foto erstellt wurde.

videoMediaMetadata

object

Nur Ausgabe Zusätzliche Metadaten zu Videomedien. Diese sind 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.

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 in diesem Feld ist ein Snapshot 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 existiert.

resourceKey

string

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

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 in der Datei.

labelInfo.labels[]

object (Label)

Nur Ausgabe Die Labels 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 Inhalten ausgefüllt, die in Google Drive gespeichert sind. Für Docs-Editoren oder Dateien mit Verknüpfungen wird 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 Inhalten ausgefüllt, die in Google Drive gespeichert sind. Für Docs-Editoren oder Dateien mit Verknüpfungen wird es nicht ausgefüllt.

ContentRestriction

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

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

reason

string

Grund, warum der Inhalt der Datei eingeschränkt ist. Dieser Parameter kann nur bei Anfragen geändert werden, in denen auch readOnly=true festgelegt wird.

type

string

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

restrictingUser

object (User)

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

restrictionTime

string

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

ownerRestricted

boolean

Gibt an, ob die Inhaltsbeschränkung nur von einem Nutzer geändert oder entfernt werden kann, dem die Datei gehört. Für Dateien in geteilten Ablagen kann jeder Nutzer mit organizer-Berechtigungen diese Inhaltsbeschränkung ändern oder entfernen.

systemRestricted

boolean

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

Methoden

copy

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

create

Erstellt eine neue Datei.

delete

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

emptyTrash

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

export

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

generateIds

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

get

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

list

Listet die Dateien des Nutzers auf.

listLabels

Listet die Labels einer Datei auf.

modifyLabels

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

update

Aktualisiert die Metadaten und/oder den Inhalt einer Datei.

watch

Abonniert Änderungen an einer Datei.