Files

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

Die Metadaten für eine Datei.

{
  "kind": "drive#file",
  "id": string,
  "name": string,
  "mimeType": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "trashingUser": {
    "kind": "drive#user",
    "displayName": string,
    "photoLink": string,
    "me": boolean,
    "permissionId": string,
    "emailAddress": string
  },
  "trashedTime": datetime,
  "parents": [
    string
  ],
  "properties": {
    (key): string
  },
  "appProperties": {
    (key): string
  },
  "spaces": [
    string
  ],
  "version": long,
  "webContentLink": string,
  "webViewLink": string,
  "iconLink": string,
  "hasThumbnail": boolean,
  "thumbnailLink": string,
  "thumbnailVersion": long,
  "viewedByMe": boolean,
  "viewedByMeTime": datetime,
  "createdTime": datetime,
  "modifiedTime": datetime,
  "modifiedByMeTime": datetime,
  "modifiedByMe": boolean,
  "sharedWithMeTime": datetime,
  "sharingUser": {
    "kind": "drive#user",
    "displayName": string,
    "photoLink": string,
    "me": boolean,
    "permissionId": string,
    "emailAddress": string
  },
  "owners": [
    {
      "kind": "drive#user",
      "displayName": string,
      "photoLink": string,
      "me": boolean,
      "permissionId": string,
      "emailAddress": string
    }
  ],
  "teamDriveId": string,
  "driveId": string,
  "lastModifyingUser": {
    "kind": "drive#user",
    "displayName": string,
    "photoLink": string,
    "me": boolean,
    "permissionId": string,
    "emailAddress": string
  },
  "shared": boolean,
  "ownedByMe": boolean,
  "capabilities": {
    "canAcceptOwnership": boolean,
    "canAddChildren": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canChangeViewersCanCopyContent": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDelete": boolean,
    "canDeleteChildren": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canModifyContent": boolean,
    "canModifyContentRestriction": boolean,
    "canModifyLabels": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemWithinDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canReadLabels": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canReadDrive": boolean,
    "canRemoveChildren": boolean,
    "canRemoveMyDriveParent": boolean,
    "canRename": boolean,
    "canShare": boolean,
    "canTrash": boolean,
    "canTrashChildren": boolean,
    "canUntrash": boolean
  },
  "viewersCanCopyContent": boolean,
  "copyRequiresWriterPermission": boolean,
  "writersCanShare": boolean,
  "permissions": [
    permissions Resource
  ],
  "permissionIds": [
    string
  ],
  "hasAugmentedPermissions": boolean,
  "folderColorRgb": string,
  "originalFilename": string,
  "fullFileExtension": string,
  "fileExtension": string,
  "md5Checksum": string,
  "sha1Checksum": string,
  "sha256Checksum": string,
  "size": long,
  "quotaBytesUsed": long,
  "headRevisionId": string,
  "contentHints": {
    "thumbnail": {
      "image": bytes,
      "mimeType": string
    },
    "indexableText": string
  },
  "imageMediaMetadata": {
    "width": integer,
    "height": integer,
    "rotation": integer,
    "location": {
      "latitude": double,
      "longitude": double,
      "altitude": double
    },
    "time": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": float,
    "aperture": float,
    "flashUsed": boolean,
    "focalLength": float,
    "isoSpeed": integer,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "exposureBias": float,
    "maxApertureValue": float,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": long
  },
  "isAppAuthorized": boolean,
  "exportLinks": {
    (key): string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      "readOnly": boolean,
      "reason": string,
      "restrictingUser": {
        "kind": "drive#user",
        "displayName": string,
        "photoLink": string,
        "me": boolean,
        "permissionId": string,
        "emailAddress": string
      },
      "restrictionTime": datetime,
      "type": string
    }
  ],
  "labelInfo": {
    "labels": [
      {
        "kind": "drive#label",
        "id": string,
        "revisionId": string,
        "fields": {
          (key): {
            "kind": "drive#labelField",
            "id": string,
            "valueType": string,
            "dateString": [
              date
            ],
            "integer": [
              long
            ],
            "selection": [
              string
            ],
            "text": [
              string
            ],
            "user": [
              {
                "kind": "drive#user",
                "displayName": string,
                "photoLink": string,
                "me": boolean,
                "permissionId": string,
                "emailAddress": string
              }
            ]
          }
        }
      }
    ]
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  }
}
Attributname Wert Beschreibung Hinweise
kind string Gibt die Art der Ressource an. Wert: der feste String "drive#file".
id string Die ID der Datei. Bearbeitbar
name string Der Name der Datei. Sie müssen nicht unbedingt innerhalb eines Ordners eindeutig sein. Hinweis: Bei unveränderlichen Elementen wie den Ordnern der obersten Ebene von geteilten Ablagen, dem Stammordner von „Meine Ablage“ und dem Ordner für Anwendungsdaten ist der Name konstant. Bearbeitbar
mimeType string Der MIME-Typ der Datei.

Wenn kein Wert angegeben ist, versucht Google Drive, automatisch einen geeigneten 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 von Google Docs erstellt wird, werden die hochgeladenen Inhalte nach Möglichkeit importiert. Die unterstützten Importformate werden unter „Info“ veröffentlicht.

Bearbeitbar
description string Eine kurze Beschreibung der Datei. Bearbeitbar
starred boolean Gibt an, ob der Nutzer die Datei markiert hat. Bearbeitbar
trashed boolean Gibt an, ob die Datei entweder explizit oder aus dem Papierkorb in den Papierkorb verschoben wurde. Nur der Eigentümer darf eine Datei in den Papierkorb verschieben. Das in den Papierkorb verschobene Element wird aus allen „file.list“-Antworten für alle Nutzer ausgeschlossen, denen die Datei nicht gehört. Allerdings können alle Nutzer mit Zugriff auf die Datei die in den Papierkorb verschobenen Elementmetadaten in einer API-Antwort sehen. Alle Nutzer mit Zugriff können die Datei kopieren, herunterladen, exportieren und freigeben. Bearbeitbar
explicitlyTrashed boolean Gibt an, ob die Datei explizit in den Papierkorb verschoben wurde, statt rekursiv aus dem übergeordneten Ordner in den Papierkorb verschoben zu werden.
parents[] list Die IDs der übergeordneten Ordner, die die Datei enthalten.

Wenn die Datei nicht im Rahmen einer Erstellungsanfrage angegeben wurde, wird sie direkt im Ordner „Meine Ablage“ des Nutzers abgelegt. Wenn die Datei nicht als Teil einer Kopiesanfrage angegeben wird, übernimmt sie alle übergeordneten Elemente der Quelldatei. Aktualisierungsanfragen müssen die Parameter addParents und removeParents verwenden, um die übergeordnete Liste zu ändern.

Bearbeitbar
properties object 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.

Bearbeitbar
properties.(key) string
appProperties object Eine Sammlung beliebiger Schlüssel/Wert-Paare, die nur für die anfragende 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. Sie können keinen API-Schlüssel verwenden, um private Properties abzurufen.

Bearbeitbar
appProperties.(key) string
spaces[] list Die Liste der Gruppenbereiche, die die Datei enthalten. Aktuell werden die Werte 'drive', 'appDataFolder' und 'photos' unterstützt.
version long Eine kontinuierlich ansteigende Versionsnummer für die Datei. Dies spiegelt alle Änderungen an der Datei auf dem Server wider, auch die, die für den Nutzer nicht sichtbar sind.
viewedByMe boolean Gibt an, ob der Nutzer die Datei aufgerufen hat.
viewedByMeTime datetime Der Zeitpunkt, zu dem die Datei zuletzt vom Nutzer aufgerufen wurde (RFC 3339-Datum/Uhrzeit). Bearbeitbar
createdTime datetime Der Zeitpunkt, zu dem die Datei erstellt wurde (RFC 3339-Datum/Uhrzeit). Bearbeitbar
modifiedTime datetime Der Zeitpunkt, zu dem die Datei zuletzt von jemandem geändert wurde (Datum/Uhrzeit gemäß RFC 3339).

Hinweis: Durch das Festlegen von „modifizierte Zeit“ wird auch „modifyByMeTime“ für den Nutzer aktualisiert.

Bearbeitbar
modifiedByMeTime datetime Der Zeitpunkt der letzten Änderung der Datei durch den Nutzer (Datum/Uhrzeit gemäß RFC 3339).
sharedWithMeTime datetime Der Zeitpunkt, zu dem die Datei für den Nutzer freigegeben wurde, falls zutreffend (Datum/Uhrzeit gemäß RFC 3339).
sharingUser nested object Der Nutzer, der die Datei für den anfragenden Nutzer freigegeben hat (falls zutreffend).
sharingUser.kind string Gibt die Art der Ressource an. Wert: der feste String "drive#user".
sharingUser.displayName string Ein Nur-Text-Anzeigename für diesen Nutzer.
sharingUser.me boolean Gibt an, ob dieser Nutzer der anfragende Nutzer ist.
sharingUser.permissionId string Die Nutzer-ID, wie sie in den Berechtigungsressourcen sichtbar ist.
sharingUser.emailAddress string Die E-Mail-Adresse des Nutzers. Unter Umständen ist sie in bestimmten Kontexten nicht vorhanden, wenn der Nutzer seine E-Mail-Adresse nicht für den Antragsteller sichtbar gemacht hat.
owners[] list Der Eigentümer dieser Datei. Nur bestimmte alte Dateien können mehrere Eigentümer haben. Dieses Feld wird nicht für Elemente in geteilten Ablagen ausgefüllt.
owners[].kind string Gibt die Art der Ressource an. Wert: der feste String "drive#user".
owners[].displayName string Ein Nur-Text-Anzeigename für diesen Nutzer.
owners[].me boolean Gibt an, ob dieser Nutzer der anfragende Nutzer ist.
owners[].permissionId string Die Nutzer-ID, wie sie in den Berechtigungsressourcen sichtbar ist.
owners[].emailAddress string Die E-Mail-Adresse des Nutzers. Unter Umständen ist sie in bestimmten Kontexten nicht vorhanden, wenn der Nutzer seine E-Mail-Adresse nicht für den Antragsteller sichtbar gemacht hat.
lastModifyingUser nested object Der letzte Nutzer, der die Datei ändert.
lastModifyingUser.kind string Gibt die Art der Ressource an. Wert: der feste String "drive#user".
lastModifyingUser.displayName string Ein Nur-Text-Anzeigename für diesen Nutzer.
lastModifyingUser.me boolean Gibt an, ob dieser Nutzer der anfragende Nutzer ist.
lastModifyingUser.permissionId string Die Nutzer-ID, wie sie in den Berechtigungsressourcen sichtbar ist.
lastModifyingUser.emailAddress string Die E-Mail-Adresse des Nutzers. Unter Umständen ist sie in bestimmten Kontexten nicht vorhanden, wenn der Nutzer seine E-Mail-Adresse nicht für den Antragsteller sichtbar gemacht hat.
shared boolean Gibt an, ob die Datei freigegeben wurde. Wird nicht für Elemente in geteilten Ablagen ausgefüllt.
ownedByMe boolean Gibt an, ob der Nutzer der Eigentümer der Datei ist. Wird nicht für Elemente in geteilten Ablagen ausgefüllt.
viewersCanCopyContent boolean Eingestellt. Verwenden Sie stattdessen copyRequiresWriterPermission.
writersCanShare boolean Gibt an, ob Nutzer mit writer-Berechtigung die Berechtigungen der Datei ändern dürfen. Wird nicht für Elemente in geteilten Ablagen ausgefüllt. Bearbeitbar
permissions[] list 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 nicht für Elemente in geteilten Ablagen ausgefüllt.
folderColorRgb string Die Farbe eines Ordners oder die Verknüpfung zu einem Ordner als RGB-Hexadezimalwert. Die unterstützten Farben werden im Feld folderColorPalette der Inforessource angezeigt.

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

Bearbeitbar
originalFilename string Der ursprüngliche Dateiname der hochgeladenen Inhalte, 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. Bearbeitbar
fullFileExtension string Die vollständige Dateierweiterung, 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.

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

fileExtension string Die letzte Komponente von fullFileExtension. Diese Option ist nur für Dateien mit binären Inhalten in Google Drive verfügbar.
md5Checksum string Die MD5-Prüfsumme für den Inhalt der Datei. Dies gilt nur für Dateien mit binären Inhalten in Google Drive.
size long Die Größe des Dateiinhalts in Byte. Dieses Feld wird bei Dateien mit binären Inhalten, die in Google Drive und in Docs-Editoren gespeichert sind, ausgefüllt und bei Verknüpfungen oder Ordnern nicht ausgefüllt.
quotaBytesUsed long Die Anzahl der von der Datei verwendeten Speicherkontingentbyte. Dazu gehören die Kopfüberarbeitung und vorherige Überarbeitungen, für die keepForever aktiviert ist.
headRevisionId string Die ID der Kopfüberarbeitung der Datei. Diese Funktion ist derzeit nur für Dateien mit binären Inhalten in Google Drive verfügbar.
contentHints object Zusätzliche Informationen zum Inhalt der Datei. Diese Felder werden in Antworten nie ausgefüllt.
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 bytes Die Miniaturansichtdaten, die mit URL-sicherem Base64-Code codiert sind (RFC 4648, Abschnitt 5). Bearbeitbar
contentHints.thumbnail.mimeType string Der MIME-Typ des Thumbnails. Bearbeitbar
contentHints.indexableText string Zu indexierender Text für die Datei, um Volltext-Abfragen zu verbessern. Sie ist auf 128 KB beschränkt und kann HTML-Elemente enthalten. Weitere Informationen finden Sie unter Dateimetadaten verwalten. Bearbeitbar
imageMediaMetadata object Zusätzliche Metadaten zu Bildmedien, falls verfügbar.
imageMediaMetadata.width integer Die Breite des Bilds in Pixeln
imageMediaMetadata.height integer Die Höhe des Bilds in Pixeln
imageMediaMetadata.rotation integer Die Anzahl der 90-Grad-Drehungen im Uhrzeigersinn ab der ursprünglichen Ausrichtung des Bildes.
imageMediaMetadata.location object Im Bild gespeicherte geografische Standortinformationen.
imageMediaMetadata.location.latitude double Der im Bild gespeicherte Breitengrad.
imageMediaMetadata.location.longitude double Der im Bild gespeicherte Längengrad.
imageMediaMetadata.location.altitude double Die im Bild gespeicherte Höhe.
imageMediaMetadata.time string Datum und Uhrzeit der Fotoaufnahme (EXIF DateTime).
imageMediaMetadata.cameraMake string Die Marke der Kamera, mit der das Foto erstellt wurde.
imageMediaMetadata.cameraModel string Das Modell der Kamera, mit der das Foto erstellt wurde.
imageMediaMetadata.exposureTime float Die Länge der Belichtung in Sekunden.
imageMediaMetadata.aperture float Die zum Erstellen des Fotos verwendete Blende (f-Zahl).
imageMediaMetadata.flashUsed boolean Gibt an, ob zum Erstellen des Fotos ein Blitz verwendet wurde.
imageMediaMetadata.focalLength float Die Brennweite, die zum Erstellen des Fotos verwendet wird, in Millimeter.
imageMediaMetadata.isoSpeed integer Die ISO-Geschwindigkeit, mit der das Foto erstellt wurde.
imageMediaMetadata.meteringMode string Der für die Erstellung des Fotos verwendete Metering-Modus.
imageMediaMetadata.sensor string Der Sensortyp, der für die Erstellung des Fotos verwendet wurde.
imageMediaMetadata.exposureMode string Belichtungsmodus, der zur Erstellung des Fotos verwendet wurde
imageMediaMetadata.colorSpace string Der Farbraum des Fotos.
imageMediaMetadata.whiteBalance string Der zum Erstellen des Fotos verwendete Weißabgleichmodus.
imageMediaMetadata.exposureBias float Belichtungskorrektur des Fotos (APEX-Wert)
imageMediaMetadata.maxApertureValue float Die kleinste f-Zahl des Objektivs in der Brennweite, die zum Erstellen des Fotos verwendet wird (APEX-Wert).
imageMediaMetadata.subjectDistance integer Die Entfernung zum Motiv des Fotos in Metern.
imageMediaMetadata.lens string Das Objektiv, mit dem das Foto erstellt wurde.
videoMediaMetadata object Zusätzliche Metadaten zu Videomedien. Diese Option ist nach dem Upload möglicherweise nicht sofort verfügbar.
videoMediaMetadata.width integer Die Breite des Videos in Pixeln.
videoMediaMetadata.height integer Die Höhe des Videos in Pixeln.
videoMediaMetadata.durationMillis long Dauer des Videos in Millisekunden.
capabilities object Funktionen des aktuellen Nutzers für diese Datei. Jede Funktion entspricht einer detaillierten Aktion, die ein Nutzer ausführen kann.
capabilities.canEdit boolean Gibt an, ob der aktuelle Nutzer diese Datei bearbeiten darf. Andere Faktoren können die Art der Änderungen einschränken, die ein Nutzer an einer Datei vornehmen kann. Beispiel: canChangeCopyRequiresWriterPermission oder canModifyContent.
capabilities.canComment boolean Gibt an, ob der aktuelle Nutzer diese Datei kommentieren darf.
capabilities.canShare boolean Gibt an, ob der aktuelle Nutzer die Freigabeeinstellungen für diese Datei ändern darf.
capabilities.canCopy boolean Gibt an, ob der aktuelle Nutzer diese Datei kopieren darf. Gibt an, ob für ein Element in einer geteilten Ablage untergeordnete Elemente, die keine Ordner sind, kopiert werden können oder wenn das Element selbst kein Ordner ist.
capabilities.canReadRevisions boolean Gibt an, ob der aktuelle Nutzer die Überarbeitungsressource dieser Datei lesen kann. Gibt an, ob für ein Element in einer geteilten Ablage Überarbeitungen von untergeordneten Elementen, die keine Ordner sind, dieses Element oder dieses Element selbst, wenn es kein Ordner ist, gelesen werden können.
isAppAuthorized boolean Gibt an, ob die Datei von der anfragenden App erstellt oder geöffnet wurde.
hasThumbnail boolean Gibt an, ob diese Datei eine Miniaturansicht hat. Dies gibt nicht an, ob die anfragende App Zugriff auf das Thumbnail hat. Suchen Sie nach dem Feld „thumbnailLink“, um den Zugriff zu prüfen.
thumbnailVersion long Die Thumbnail-Version zur Verwendung im Thumbnail-Cache.
modifiedByMe boolean Gibt an, ob die Datei von diesem Nutzer geändert wurde.
trashingUser nested object Wenn die Datei explizit in den Papierkorb verschoben wurde, ist das der Nutzer, der sie in den Papierkorb verschoben hat. Wird nur für Elemente in geteilten Ablagen ausgefüllt.
trashingUser.kind string Gibt die Art der Ressource an. Wert: der feste String "drive#user".
trashingUser.displayName string Ein Nur-Text-Anzeigename für diesen Nutzer.
trashingUser.me boolean Gibt an, ob dieser Nutzer der anfragende Nutzer ist.
trashingUser.permissionId string Die Nutzer-ID, wie sie in den Berechtigungsressourcen sichtbar ist.
trashingUser.emailAddress string Die E-Mail-Adresse des Nutzers. Unter Umständen ist sie in bestimmten Kontexten nicht vorhanden, wenn der Nutzer seine E-Mail-Adresse nicht für den Antragsteller sichtbar gemacht hat.
trashedTime datetime 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.
teamDriveId string Eingestellt. Verwenden Sie stattdessen driveId.
capabilities.canAddChildren boolean Gibt an, ob der aktuelle Nutzer diesem Ordner untergeordnete Elemente hinzufügen darf. Das ist immer „falsch“, wenn das Element kein Ordner ist.
capabilities.canDelete boolean Gibt an, ob der aktuelle Nutzer diese Datei löschen darf.
capabilities.canDownload boolean Gibt an, ob der aktuelle Nutzer diese Datei herunterladen darf.
capabilities.canListChildren boolean Gibt an, ob der aktuelle Nutzer die untergeordneten Elemente in diesem Ordner auflisten darf. Das ist immer „falsch“, wenn das Element kein Ordner ist.
capabilities.canMoveTeamDriveItem boolean Eingestellt. Verwende stattdessen canMoveItemWithinDrive oder canMoveItemOutOfDrive.
capabilities.canMoveItemIntoTeamDrive boolean Eingestellt. Verwenden Sie stattdessen canMoveItemOutOfDrive.
capabilities.canReadTeamDrive boolean Eingestellt. Verwenden Sie stattdessen canReadDrive.
capabilities.canRemoveChildren boolean Gibt an, ob der aktuelle Nutzer untergeordnete Elemente aus diesem Ordner entfernen darf. Das ist immer „falsch“, wenn das Element kein Ordner ist. Verwenden Sie für einen Ordner in einer geteilten Ablage stattdessen canDeleteChildren oder canTrashChildren.
capabilities.canRename boolean Gibt an, ob der aktuelle Nutzer diese Datei umbenennen darf.
capabilities.canTrash boolean Gibt an, ob der aktuelle Nutzer diese Datei in den Papierkorb verschieben darf.
capabilities.canUntrash boolean Gibt an, ob der aktuelle Nutzer diese Datei aus dem Papierkorb wiederherstellen kann.
hasAugmentedPermissions boolean Gibt an, ob Berechtigungen direkt für diese Datei vorhanden sind. Dieses Feld wird nur für Elemente in geteilten Ablagen ausgefüllt.
capabilities.canChangeViewersCanCopyContent boolean Veraltet
permissionIds[] list Liste der Berechtigungs-IDs für Nutzer mit Zugriff auf diese Datei.
capabilities.canChangeCopyRequiresWriterPermission boolean Gibt an, ob der aktuelle Nutzer die Einschränkung copyRequiresWriterPermission dieser Datei ändern darf.
copyRequiresWriterPermission boolean Gibt an, ob die Optionen zum Kopieren, Drucken oder Herunterladen dieser Datei für Leser und Kommentatoren deaktiviert sein sollen. Bearbeitbar
capabilities.canDeleteChildren boolean Gibt an, ob der aktuelle Nutzer untergeordnete Ordner dieses Ordners löschen darf. Das ist „false“, wenn das Element kein Ordner ist. Wird nur für Elemente in geteilten Ablagen ausgefüllt.
capabilities.canMoveChildrenOutOfTeamDrive boolean Eingestellt. Verwenden Sie stattdessen canMoveChildrenOutOfDrive.
capabilities.canMoveChildrenWithinTeamDrive boolean Eingestellt. Verwenden Sie stattdessen canMoveChildrenWithinDrive.
capabilities.canMoveItemOutOfTeamDrive boolean Eingestellt. Verwenden Sie stattdessen canMoveItemOutOfDrive.
capabilities.canMoveItemWithinTeamDrive boolean Eingestellt. Verwenden Sie stattdessen canMoveItemWithinDrive.
capabilities.canTrashChildren boolean 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.
exportLinks.(key) string Eine Zuordnung vom Exportformat zur URL
driveId string ID der geteilten Ablage, in der sich die Datei befindet. Wird nur für Elemente in geteilten Ablagen ausgefüllt.
capabilities.canMoveChildrenOutOfDrive boolean Gibt an, ob der aktuelle Nutzer untergeordnete Ordner dieses Ordners aus der geteilten Ablage verschieben darf. Das ist „false“, wenn das Element kein Ordner ist. Wird nur für Elemente in geteilten Ablagen ausgefüllt.
capabilities.canMoveChildrenWithinDrive boolean Gibt an, ob der aktuelle Nutzer untergeordnete Elemente dieses Ordners innerhalb dieser Ablage verschieben kann. Das ist „false“, wenn das Element kein Ordner ist. Beachten Sie, dass eine Anfrage zum Verschieben des untergeordneten Elements abhängig vom Zugriff des aktuellen Nutzers auf das untergeordnete und den Zielordner weiterhin fehlschlagen kann.
capabilities.canMoveItemOutOfDrive boolean Gibt an, ob der aktuelle Nutzer dieses Element verschieben darf, indem er sein übergeordnetes Element ändert. Je nachdem, welches neue übergeordnete Element hinzugefügt wird, kann eine Anfrage zum Ändern des übergeordneten Elements fehlschlagen.
capabilities.canMoveItemWithinDrive boolean Gibt an, ob der aktuelle Nutzer dieses Element innerhalb dieser Ablage verschieben darf. Beachten Sie, dass eine Anfrage zum Ändern des übergeordneten Elements abhängig vom neuen übergeordneten Element und dem entfernten übergeordneten Element möglicherweise fehlschlägt.
capabilities.canReadDrive boolean 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.canModifyContent boolean Gibt an, ob der aktuelle Nutzer den Inhalt dieser Datei ändern darf.
capabilities.canAddMyDriveParent boolean Gibt an, ob der aktuelle Nutzer ein übergeordnetes Element für das Element hinzufügen kann, ohne ein übergeordnetes Element in derselben Anfrage zu entfernen. Wird für Dateien in geteilten Ablagen nicht ausgefüllt.
capabilities.canRemoveMyDriveParent boolean Gibt an, ob der aktuelle Nutzer ein übergeordnetes Element aus dem Element entfernen kann, ohne ein weiteres übergeordnetes Element in derselben Anfrage hinzuzufügen. Wird für Dateien in geteilten Ablagen nicht ausgefüllt.
shortcutDetails object Details zur Verknüpfungsdatei. Wird nur für Verknüpfungsdateien eingefügt, in denen das Feld „mimeType“ auf application/vnd.google-apps.shortcut festgelegt ist.
shortcutDetails.targetId string Die ID der Datei, auf die diese Verknüpfung verweist. Bearbeitbar
shortcutDetails.targetMimeType string 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 erfasst wird.
capabilities.canAddFolderFromAnotherDrive boolean Gibt an, ob der aktuelle Nutzer diesem Ordner einen Ordner aus einer anderen Ablage (andere geteilte Ablage oder „Meine Ablage“) hinzufügen darf. Das ist „false“, wenn das Element kein Ordner ist. Wird nur für Elemente in geteilten Ablagen ausgefüllt.
capabilities.canModifyContentRestriction boolean Gibt an, ob der aktuelle Nutzer die Einschränkungen für den Inhalt dieser Datei ändern darf.
contentRestrictions[] list Einschränkungen für den Zugriff auf den Inhalt der Datei. Wird nur eingefügt, wenn eine solche Einschränkung vorhanden ist.
contentRestrictions[].readOnly boolean Gibt an, ob der Inhalt der Datei schreibgeschützt ist. Wenn eine Datei schreibgeschützt ist, kann sie nicht neu hinzugefügt, keine Kommentare hinzugefügt oder geändert werden und der Titel der Datei darf nicht geändert werden. Bearbeitbar
contentRestrictions[].reason string Grund für die Einschränkung des Inhalts der Datei. Dies ist nur bei Anfragen möglich, bei denen auch readOnly=true festgelegt wurde. Bearbeitbar
contentRestrictions[].restrictingUser nested object Der Nutzer, der die Inhaltsbeschränkung festgelegt hat. Wird nur ausgefüllt, wenn readOnly „true“ ist.
contentRestrictions[].restrictingUser.kind string Gibt die Art der Ressource an. Wert: der feste String "drive#user".
contentRestrictions[].restrictingUser.displayName string Ein Nur-Text-Anzeigename für diesen Nutzer.
contentRestrictions[].restrictingUser.me boolean Gibt an, ob dieser Nutzer der anfragende Nutzer ist.
contentRestrictions[].restrictingUser.permissionId string Die Nutzer-ID, wie sie in den Berechtigungsressourcen sichtbar ist.
contentRestrictions[].restrictingUser.emailAddress string Die E-Mail-Adresse des Nutzers. Unter Umständen ist sie in bestimmten Kontexten nicht vorhanden, wenn der Nutzer seine E-Mail-Adresse nicht für den Antragsteller sichtbar gemacht hat.
contentRestrictions[].restrictionTime datetime Der Zeitpunkt, zu dem die Inhaltsbeschränkung festgelegt wurde (formatierter RFC 3339-Zeitstempel). Wird nur ausgefüllt, wenn readOnly „true“ ist.
contentRestrictions[].type string Die Art der Inhaltseinschränkung. Der einzig mögliche Wert ist derzeit globalContentRestriction.
capabilities.canChangeSecurityUpdateEnabled boolean Gibt an, ob der aktuelle Nutzer das Feld „securityUpdateEnabled“ für Metadaten zur Linkfreigabe ändern darf.
shortcutDetails.targetResourceKey string Der ResourceKey für die Zieldatei.
resourceKey string Ein Schlüssel, der für den Zugriff auf das Element über einen freigegebenen Link erforderlich ist.
linkShareMetadata object Enthält Details zu den Link-URLs, mit denen Kunden auf dieses Element verweisen.
linkShareMetadata.securityUpdateEligible boolean Gibt an, ob die Datei für ein Sicherheitsupdate geeignet ist.
linkShareMetadata.securityUpdateEnabled boolean Gibt an, ob das Sicherheitsupdate für diese Datei aktiviert ist.
capabilities.canAcceptOwnership boolean Gibt an, ob der aktuelle Nutzer der ausstehende Eigentümer der Datei ist. Wird für Dateien in geteilten Ablagen nicht ausgefüllt.
capabilities.canModifyLabels boolean Gibt an, ob der aktuelle Nutzer die Labels in dieser Datei ändern darf.
capabilities.canReadLabels boolean Gibt an, ob der aktuelle Nutzer die Labels in dieser Datei lesen kann.
labelInfo object Eine Übersicht der Labels in der Datei.
labelInfo.labels[] list Die Gruppe von Labels in der Datei, wie von den Label-IDs im Parameter includeLabels angefordert. Standardmäßig werden keine Labels zurückgegeben.
labelInfo.labels[].kind string Dies ist immer drive#label.
labelInfo.labels[].id string Die ID des Labels.
labelInfo.labels[].revisionId string Die Überarbeitungs-ID des Labels.
labelInfo.labels[].fields object Eine Zuordnung der Felder des Labels mit der Schlüssel-ID.
labelInfo.labels[].fields.(key) nested object
labelInfo.labels[].fields.(key).kind string Das ist immer drive#labelField.
labelInfo.labels[].fields.(key).id string Die ID dieses Felds.
labelInfo.labels[].fields.(key).valueType string Der Feldtyp. Neue Werte werden möglicherweise in Zukunft unterstützt. Derzeit sind folgende Werte zulässig:
  • DatumString
  • integer
  • Auswahl
  • Text
  • Nutzer
labelInfo.labels[].fields.(key).dateString[] list Nur vorhanden, wenn valueType dateString ist. Datum gemäß RFC 3339: JJJJ-MM-TT.
labelInfo.labels[].fields.(key).integer[] list Nur vorhanden, wenn valueType integer ist.
labelInfo.labels[].fields.(key).selection[] list Nur vorhanden, wenn valueType selection ist.
labelInfo.labels[].fields.(key).text[] list Nur vorhanden, wenn valueType text ist.
labelInfo.labels[].fields.(key).user[] list Nur vorhanden, wenn valueType user ist.
labelInfo.labels[].fields.(key).user[].kind string Gibt die Art der Ressource an. Wert: der feste String "drive#user".
labelInfo.labels[].fields.(key).user[].displayName string Ein Nur-Text-Anzeigename für diesen Nutzer.
labelInfo.labels[].fields.(key).user[].me boolean Gibt an, ob dieser Nutzer der anfragende Nutzer ist.
labelInfo.labels[].fields.(key).user[].permissionId string Die Nutzer-ID, wie sie in den Berechtigungsressourcen sichtbar ist.
labelInfo.labels[].fields.(key).user[].emailAddress string Die E-Mail-Adresse des Nutzers. Unter Umständen ist sie in bestimmten Kontexten nicht vorhanden, wenn der Nutzer seine E-Mail-Adresse nicht für den Antragsteller sichtbar gemacht hat.
sha1Checksum string Die mit dieser Datei verknüpfte SHA1-Prüfsumme, falls verfügbar. Dieses Feld wird nur für Dateien ausgefüllt, die in Google Drive gespeichert sind. Für Docs-Editoren oder Verknüpfungsdateien wird es nicht ausgefüllt.
sha256Checksum string Die mit dieser Datei verknüpfte SHA256-Prüfsumme, falls verfügbar. Dieses Feld wird nur für Dateien ausgefüllt, die in Google Drive gespeichert sind. Für Docs-Editoren oder Verknüpfungsdateien wird es nicht ausgefüllt.

Methoden

Kopieren
Erstellt eine Kopie einer Datei und wendet alle angeforderten Aktualisierungen mit Patch-Semantik an. Ordner können nicht kopiert werden.
Erstellen
Eine Datei wird erstellt.
Delete
Dateien, deren Eigentümer der Nutzer ist, werden endgültig gelöscht, ohne dass sie in den Papierkorb verschoben werden. Wenn die Datei zu einer geteilten Ablage gehört, muss der Nutzer Organisator der übergeordneten Datei sein. Wenn das Ziel ein Ordner ist, werden auch alle untergeordneten Elemente des Nutzers gelöscht.
leeren Papierkorb
Löscht alle Dateien, die sich im Papierkorb des Nutzers befinden.
Exportieren
Exportiert ein Google Workspace-Dokument in den angeforderten MIME-Typ und gibt den exportierten Byteinhalt zurück. Der Exportinhalt ist auf 10 MB begrenzt.
generateIds angeben.
Generiert eine Gruppe von Datei-IDs, die in Erstellungs- oder Kopieranfragen zur Verfügung gestellt werden können.
erhalten
Ruft die Metadaten oder den Inhalt einer Datei nach ID ab.
list
Dateien auflisten oder durchsuchen.
Aktualisieren
Aktualisiert die Metadaten und/oder den Inhalt einer Datei. Wenn Sie diese Methode aufrufen, füllen Sie nur Felder in der Anfrage aus, die Sie ändern möchten. Beim Aktualisieren von Feldern können einige Felder automatisch geändert werden, z. B. „ModifiedDate“. Diese Methode unterstützt die Patch-Semantik.
ansehen
Hat Änderungen an einer Datei abonniert Sie können zwar einen Kanal für Änderungen an einer Datei in einer geteilten Ablage einrichten, bei einer Änderung an einer Datei in einer geteilten Ablage wird jedoch keine Benachrichtigung erstellt.
listLabels
Listet die Labels einer Datei auf.
Labels ändern
Änderung des Labelsatzes für eine Datei