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 |
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. | |
webContentLink |
string |
Ein Link zum Herunterladen des Inhalts der Datei in einem Browser. Diese Option ist nur für Dateien mit binären Inhalten in Google Drive verfügbar. | |
webViewLink |
string |
Ein Link zum Öffnen der Datei in einem relevanten Google-Editor oder -Viewer in einem Browser. | |
iconLink |
string |
Ein statischer, nicht authentifizierter Link zum Symbol der Datei. | |
thumbnailLink |
string |
Ein kurzlebiger Link zum Thumbnail der Datei, falls verfügbar. Dauert in der Regel innerhalb von Stunden. Wird nur ausgefüllt, wenn die anfragende App auf den Inhalt der Datei zugreifen kann. Wenn die Datei nicht öffentlich freigegeben ist, muss die in Files.thumbnailLink zurückgegebene URL mit einer Anfrage mit Anmeldedaten abgerufen werden. |
|
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.photoLink |
string |
Ein Link zum Profilbild des Nutzers, falls verfügbar. | |
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[].photoLink |
string |
Ein Link zum Profilbild des Nutzers, falls verfügbar. | |
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.photoLink |
string |
Ein Link zum Profilbild des Nutzers, falls verfügbar. | |
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 |
|
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.photoLink |
string |
Ein Link zum Profilbild des Nutzers, falls verfügbar. | |
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 |
object |
Links zum Exportieren von Dateien aus den Docs-Editoren in bestimmte Formate | |
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.photoLink |
string |
Ein Link zum Profilbild des Nutzers, falls verfügbar. | |
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:
|
|
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[].photoLink |
string |
Ein Link zum Profilbild des Nutzers, falls verfügbar. | |
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