Ресурс: Файл
Метаданные файла.
Некоторые методы работы с ресурсами (например, files.update ) требуют указания fileId . Используйте метод files.list для получения идентификатора файла.
| JSON-представление |
|---|
{ "ownerNames": [ string ], "exportLinks": { string: string, ... }, "parents": [ { object ( |
| Поля | |
|---|---|
ownerNames[] | Только для вывода. Имя (имена) владельца (владельцев) этого файла. Не заполняется для файлов на общих дисках. |
exportLinks | Только для вывода. Ссылки для экспорта файлов редактора документов в определенные форматы. Объект, содержащий список пар |
parents[] | Идентификатор родительской папки, содержащей файл. У файла может быть только одна родительская папка; указание нескольких родительских папок не поддерживается. Если файл не указан в запросе на вставку, он помещается непосредственно в папку «Мой диск» пользователя. Если файл не указан в запросе на копирование, он наследует любого доступного родительского файла исходного файла. Запросы files.update должны использовать параметры |
owners[] | Только вывод. Владелец этого файла. Только некоторые устаревшие файлы могут иметь более одного владельца. Это поле не заполняется для элементов на общих дисках. |
openWithLinks | Только для вывода. Карта, содержащая идентификаторы каждого из приложений пользователя и ссылку для открытия этого файла с помощью соответствующего приложения. Заполняется только при использовании области видимости drive.apps.readonly. Объект, содержащий список пар |
properties[] | Список объектов недвижимости. |
permissions[] | Только для вывода. Список разрешений для пользователей, имеющих доступ к этому файлу. Не заполняется для элементов на общих дисках. |
spaces[] | Только вывод. Список пространств, содержащих файл. Поддерживаемые значения: |
permissionIds[] | Только для вывода. files.list — список идентификаторов разрешений для пользователей, имеющих доступ к этому файлу. |
contentRestrictions[] | Ограничения на доступ к содержимому файла. Заполняется только при наличии такого ограничения. |
kind | Только вывод. Тип файла. Это всегда |
userPermission | Только вывод. Права доступа к этому файлу для авторизованного пользователя. |
fileExtension | Только для вывода. Удаляется последний компонент поля |
md5Checksum | Только для вывода. Контрольная сумма MD5 для содержимого этого файла. Это поле заполняется только для файлов, содержимое которых хранится в Google Диск; оно не заполняется для редакторов документов или файлов ярлыков. |
selfLink | Только для вывода. Ссылка на этот файл. |
lastModifyingUserName | Только вывод. Имя последнего пользователя, изменившего этот файл. |
editable | Только для вывода. Устарело: используйте |
writersCanShare | Позволяет ли автор делиться документом с другими пользователями. Эта информация не заполняется для файлов на общих дисках. |
downloadUrl | Только для вывода. Кратковременная ссылка для скачивания файла. Это поле заполняется только для файлов, содержимое которых хранится в Google Диск; оно не заполняется для документов Google Документов или файлов-ярлыков. |
mimeType | MIME-тип файла. Это поле можно изменить только при обновлении, например, при загрузке нового контента. Его можно оставить пустым, и MIME-тип будет определен на основе MIME-типа загруженного контента. |
driveId | Только для вывода. Идентификатор общего диска, на котором находится файл. Заполняется только для элементов, находящихся на общих дисках. |
thumbnailLink | Только вывод. Кратковременная ссылка на миниатюру файла, если она доступна. Обычно действует несколько часов. Не предназначено для прямого использования в веб-приложениях из-за протокола CORS (Cross-Origin Resource Sharing) , рекомендуется использовать прокси-сервер. Заполняется только тогда, когда запрашивающее приложение имеет доступ к содержимому файла. Если файл не является общедоступным, URL-адрес, возвращаемый в |
appDataContents | Только для вывода. Указывает, находится ли этот файл в папке «Данные приложения». |
webViewLink | Только для вывода. Ссылка, доступная только в общедоступных папках, для просмотра их статических веб-ресурсов (HTML, CSS, JS и т. д.) через веб-хостинг Google Drive. |
iconLink | Только вывод. Ссылка на значок файла. |
shared | Только для вывода. Указывает, был ли файл предоставлен в общий доступ. Не заполняется для файлов на общих дисках. |
lastModifyingUser | Только для вывода. Последний пользователь, изменивший этот файл. Это поле заполняется только в том случае, если последнее изменение было выполнено авторизованным пользователем. |
defaultOpenWithLink | Только для вывода. Ссылка для открытия этого файла с помощью приложения по умолчанию, установленного пользователем для этого файла. Заполняется только при использовании области видимости drive.apps.readonly. |
headRevisionId | Только для вывода. Идентификатор заголовочной ревизии файла. Это поле заполняется только для файлов, содержимое которых хранится в Google Диск; оно не заполняется для редакторов документов или файлов ярлыков. |
copyable | Только для вывода. Устарело: используйте |
etag | Только вывод. ETag файла. |
sharingUser | Только вывод. Пользователь, который поделился элементом с текущим пользователем (если имеется). |
alternateLink | Только для вывода. Ссылка для открытия файла в соответствующем редакторе или программе просмотра Google. |
embedLink | Только для вывода. Ссылка для встраивания файла. |
webContentLink | Только для вывода. Ссылка для загрузки содержимого файла в браузере с использованием аутентификации на основе cookie. В случаях, когда содержимое находится в открытом доступе, его можно загрузить без каких-либо учетных данных. |
fileSize | Только для вывода. Размер в байтах для больших двоичных объектов и файлов, созданных собственным редактором. Не будет заполняться для файлов, размер которых не указан, таких как ярлыки и папки. |
copyRequiresWriterPermission | Следует ли отключить для читателей и комментаторов возможность копирования, печати или загрузки этого файла? |
hasThumbnail | Только вывод. Указывает, есть ли у этого файла миниатюра. Это не говорит о том, имеет ли запрашивающее приложение доступ к миниатюре. Чтобы проверить доступ, найдите поле thumbnailLink. |
folderColorRgb | Цвет папки указывается в виде шестнадцатеричной строки RGB, если файл является папкой или ярлыком к папке. Список поддерживаемых цветов доступен в поле folderColorPalette ресурса «О программе». Если указан неподдерживаемый цвет, он будет заменен на ближайший цвет в палитре. |
id | Идентификатор файла. |
title | Заголовок этого файла. Обратите внимание, что для неизменяемых элементов, таких как папки верхнего уровня общих дисков, корневая папка "Мой диск" и папка "Данные приложения", заголовок остается неизменным. |
description | Краткое описание файла. |
labels | Группа меток для файла. |
labels.viewed | Просмотрен ли этот файл данным пользователем. |
labels.restricted | Только вывод. Устарело: используйте |
labels.starred | Указывает, отмечен ли этот файл пользователем как «избранное». |
labels.hidden | Только вывод. Устарело. |
labels.trashed | Указывает, был ли этот файл удален из корзины. Эта метка применяется ко всем пользователям, имеющим доступ к файлу; однако только владельцы могут просматривать и восстанавливать файлы из корзины. |
labels.modified | Только вывод. Указывает, был ли файл изменен этим пользователем. |
explicitlyTrashed | Только вывод. Указывает, был ли этот файл удален явно или рекурсивно. |
createdDate | Только для вывода. Время создания этого файла (отформатированная метка времени RFC 3339). |
modifiedDate | Последнее изменение этого файла кем-либо (отформатированная метка времени RFC 3339). Изменить его при обновлении можно только при наличии параметра setModifiedDate. |
modifiedByMeDate | Только для вывода. Последнее изменение этого файла пользователем (отформатированная метка времени RFC 3339). Обратите внимание, что установка modifiedDate также обновит дату modifiedByMe для пользователя, установившего эту дату. |
lastViewedByMeDate | Последнее время просмотра этого файла пользователем (отформатированная метка времени RFC 3339). |
markedViewedByMeDate | Только вывод. Устарело. |
sharedWithMeDate | Только вывод. Время, когда этот файл был предоставлен пользователю (отформатированная метка времени RFC 3339). |
quotaBytesUsed | Только для вывода. Количество байтов квоты, используемых этим файлом. |
version | Только для вывода. Монотонно возрастающий номер версии файла. Это отражает все изменения, внесенные в файл на сервере, даже те, которые не видны запрашивающему пользователю. |
indexableText | Индексируемые текстовые атрибуты для файла (могут только записываться) |
indexableText.text | Текст, подлежащий индексации для этого файла. |
originalFilename | Исходное имя файла загруженного контента, если оно доступно, или же исходное значение поля |
ownedByMe | Только для вывода. Указывает, принадлежит ли файл текущему пользователю. Не заполняется для файлов на общих дисках. |
canComment | Только для вывода. Устарело: используйте |
shareable | Только для вывода. Устарело: используйте |
fullFileExtension | Только для вывода. Полное расширение файла, извлеченное из заголовка. Может содержать несколько объединенных расширений, например, "tar.gz". Удаление расширения из заголовка не очищает это поле; однако изменение расширения в заголовке обновляет это поле. Это поле заполняется только для файлов, содержимое которых хранится в Google Диск; оно не заполняется для редакторов документов или файлов ярлыков. |
isAppAuthorized | Только вывод. Указывает, был ли файл создан или открыт запрашивающим приложением. |
teamDriveId | Только вывод. Устарело: используйте |
capabilities | Только вывод. Возможности текущего пользователя в отношении этого файла. Каждая возможность соответствует детальному действию, которое может выполнить пользователь. |
capabilities.canChangeRestrictedDownload | Только вывод. Устарело. |
capabilities.canMoveChildrenOutOfDrive | Только для вывода. Позволяет ли текущий пользователь перемещать дочерние элементы этой папки за пределы общего диска. Значение false, если элемент не является папкой. Заполняется только для элементов, находящихся на общих дисках. |
capabilities.canReadDrive | Только для вывода. Указывает, может ли текущий пользователь читать общий диск, к которому принадлежит этот файл. Заполняется только для элементов на общих дисках. |
capabilities.canEdit | Только вывод. Указывает, может ли текущий пользователь редактировать этот файл. Другие факторы могут ограничивать тип изменений, которые пользователь может вносить в файл. Например, см. |
capabilities.canCopy | Только вывод. Может ли текущий пользователь скопировать этот файл. Для элемента на общем диске — может ли текущий пользователь скопировать элементы, не являющиеся папками, или сам этот элемент, если он не является папкой. |
capabilities.canComment | Только вывод. Позволяет ли текущий пользователь оставлять комментарии к этому файлу. |
capabilities.canAddChildren | Только вывод. Указывает, может ли текущий пользователь добавлять дочерние элементы в эту папку. Это значение всегда равно false, если элемент не является папкой. |
capabilities.canDelete | Только вывод. Указывает, может ли текущий пользователь удалить этот файл. |
capabilities.canDownload | Только вывод. Указывает, может ли текущий пользователь загрузить этот файл. |
capabilities.canListChildren | Только вывод. Указывает, может ли текущий пользователь просмотреть список дочерних элементов этой папки. Это значение всегда равно false, если элемент не является папкой. |
capabilities.canRemoveChildren | Только вывод. Указывает, может ли текущий пользователь удалять дочерние элементы из этой папки. Это значение всегда равно false, если элемент не является папкой. Для папок на общем диске используйте вместо этого |
capabilities.canRename | Только вывод. Позволяет ли текущий пользователь переименовывать этот файл. |
capabilities.canTrash | Только вывод. Указывает, может ли текущий пользователь переместить этот файл в корзину. |
capabilities.canReadRevisions | Только вывод. Может ли текущий пользователь читать ресурс ревизий этого файла. Для элемента общего диска — может ли он читать ревизии потомков этого элемента, не являющихся папками, или сам этот элемент, если он не является папкой. |
capabilities.canReadTeamDrive | Только вывод. Устарело: используйте |
capabilities.canMoveTeamDriveItem | Только для вывода. Устарело: используйте |
capabilities.canChangeCopyRequiresWriterPermission | Только вывод. Указывает, может ли текущий пользователь изменить ограничение |
capabilities.canMoveItemIntoTeamDrive | Только для вывода. Устарело: используйте |
capabilities.canUntrash | Только вывод. Возможность восстановления этого файла из корзины текущим пользователем. |
capabilities.canModifyContent | Только вывод. Указывает, может ли текущий пользователь изменять содержимое этого файла. |
capabilities.canMoveItemWithinTeamDrive | Только для вывода. Устарело: используйте |
capabilities.canMoveItemOutOfTeamDrive | Только для вывода. Устарело: используйте |
capabilities.canDeleteChildren | Только для вывода. Позволяет ли текущий пользователь удалять дочерние элементы этой папки. Значение false, если элемент не является папкой. Заполняется только для элементов на общих дисках. |
capabilities.canMoveChildrenOutOfTeamDrive | Только для вывода. Устарело: используйте |
capabilities.canMoveChildrenWithinTeamDrive | Только для вывода. Устарело: используйте |
capabilities.canTrashChildren | Только для вывода. Позволяет ли текущий пользователь удалять дочерние элементы этой папки. Значение false, если элемент не является папкой. Заполняется только для элементов на общих дисках. |
capabilities.canMoveItemOutOfDrive | Только вывод. Может ли текущий пользователь переместить этот элемент за пределы этого диска, изменив его родительский элемент. Обратите внимание, что запрос на изменение родительского элемента может завершиться неудачей в зависимости от того, какой новый родительский элемент добавляется. |
capabilities.canAddMyDriveParent | Только для вывода. Позволяет ли текущий пользователь добавить родительский элемент, не удаляя существующий родительский элемент в том же запросе. Не заполняется для файлов на общих дисках. |
capabilities.canRemoveMyDriveParent | Только для вывода. Позволяет ли текущий пользователь удалить родительский элемент без добавления другого родительского элемента в том же запросе. Не заполняется для файлов на общих дисках. |
capabilities.canMoveItemWithinDrive | Только вывод. Может ли текущий пользователь перемещать этот элемент в пределах данного диска. Обратите внимание, что запрос на изменение родительского элемента может завершиться неудачей в зависимости от того, какой родительский элемент добавляется и какой удаляется. |
capabilities.canShare | Только вывод. Позволяет ли текущий пользователь изменять параметры доступа к этому файлу. |
capabilities.canMoveChildrenWithinDrive | Только вывод. Указывает, может ли текущий пользователь перемещать дочерние элементы этой папки на этом диске. Это значение равно false, если элемент не является папкой. Обратите внимание, что запрос на перемещение дочернего элемента может завершиться неудачей в зависимости от прав текущего пользователя на дочерний элемент и на целевую папку. |
capabilities.canModifyContentRestriction | Устарело: Только для вывода. Используйте один из методов: |
capabilities.canAddFolderFromAnotherDrive | Только для вывода. Позволяет ли текущий пользователь добавлять папку с другого диска (другого общего диска или «Мой диск») в эту папку. Значение false, если элемент не является папкой. Заполняется только для элементов на общих дисках. |
capabilities.canChangeSecurityUpdateEnabled | Только вывод. Позволяет ли текущий пользователь изменять поле securityUpdateEnabled в метаданных общего доступа к ссылке. |
capabilities.canAcceptOwnership | Только для вывода. Указывает, является ли текущий пользователь потенциальным владельцем файла. Не заполняется для файлов на общих дисках. |
capabilities.canReadLabels | Только вывод. Позволяет ли текущий пользователь прочитать метки в файле. |
capabilities.canModifyLabels | Только вывод. Позволяет ли текущий пользователь изменять метки в файле. |
capabilities.canModifyEditorContentRestriction | Только для вывода. Позволяет ли текущий пользователь добавлять или изменять ограничения на содержимое файла, доступ к которому ограничен редактором. |
capabilities.canModifyOwnerContentRestriction | Только вывод. Позволяет ли текущий пользователь добавлять или изменять ограничения на контент, установленные владельцем. |
capabilities.canRemoveContentRestriction | Только вывод. Указывает, существует ли ограничение на содержимое файла, которое может быть снято текущим пользователем. |
capabilities.canDisableInheritedPermissions | Только вывод. Возможность отключения унаследованных разрешений пользователем. |
capabilities.canEnableInheritedPermissions | Только вывод. Позволяет ли пользователь повторно включить унаследованные разрешения. |
hasAugmentedPermissions | Только вывод. Указывает, имеются ли прямые права доступа к этому файлу. Это поле заполняется только для элементов на общих дисках. |
trashingUser | Только для вывода. Если файл был явно удален, указывается пользователь, который его удалил. Заполняется только для элементов на общих дисках. |
canReadRevisions | Только вывод. Устарело: используйте |
thumbnailVersion | Только для вывода. Миниатюрная версия для использования при аннулировании кэша миниатюр. |
trashedDate | Только вывод. Время удаления элемента (отформатированная метка времени RFC 3339). Заполняется только для элементов на общих дисках. |
thumbnail | Миниатюра для файла. Она будет использоваться только в том случае, если стандартная миниатюра не может быть создана. |
thumbnail.image | Безопасные для использования в URL-адресах байты изображения-миниатюры, закодированные в Base64. Они должны соответствовать разделу 5 RFC 4648. Строка, закодированная в формате Base64. |
thumbnail.mimeType | MIME-тип миниатюры. |
imageMediaMetadata | Только для вывода. Метаданные о медиафайлах изображений. Эта информация будет присутствовать только для изображений определенного типа, и ее содержимое будет зависеть от того, что можно извлечь из содержимого изображения. |
imageMediaMetadata.flashUsed | Только вывод. Была ли использована вспышка для создания фотографии. |
imageMediaMetadata.meteringMode | Только вывод. Режим замера экспозиции, использованный для создания фотографии. |
imageMediaMetadata.sensor | Только выходные данные. Тип датчика, использованного для создания фотографии. |
imageMediaMetadata.exposureMode | Только результат. Режим экспозиции, использованный для создания фотографии. |
imageMediaMetadata.colorSpace | Только вывод. Цветовое пространство фотографии. |
imageMediaMetadata.whiteBalance | Только вывод. Режим баланса белого, использованный для создания фотографии. |
imageMediaMetadata.width | Только для вывода. Ширина изображения в пикселях. |
imageMediaMetadata.height | Только вывод. Высота изображения в пикселях. |
imageMediaMetadata.location | Только для вывода. Информация о географическом местоположении хранится в изображении. |
imageMediaMetadata.location.latitude | Только для вывода. Широта, хранящаяся в изображении. |
imageMediaMetadata.location.longitude | Только вывод. Долгота, хранящаяся в изображении. |
imageMediaMetadata.location.altitude | Только вывод. Высота сохранена в изображении. |
imageMediaMetadata.rotation | Только для вывода. Количество поворотов на 90 градусов по часовой стрелке, примененных к исходной ориентации изображения. |
imageMediaMetadata.date | Только вывод. Дата и время съемки фотографии (метка времени в формате EXIF). |
imageMediaMetadata.cameraMake | Только выходной сигнал. Марка камеры, использованной для создания фотографии. |
imageMediaMetadata.cameraModel | Только выходные данные. Модель камеры, использованной для создания фотографии. |
imageMediaMetadata.exposureTime | Только вывод. Длительность экспозиции в секундах. |
imageMediaMetadata.aperture | Только выходной сигнал. Диафрагма, использованная для создания фотографии (число f). |
imageMediaMetadata.focalLength | Только для вывода. Фокусное расстояние, использованное для создания фотографии, в миллиметрах. |
imageMediaMetadata.isoSpeed | Только для вывода. Чувствительность ISO, использованная при создании фотографии. |
imageMediaMetadata.exposureBias | Только вывод. Смещение экспозиции фотографии (значение APEX). |
imageMediaMetadata.maxApertureValue | Только для вывода. Наименьшее значение диафрагмы объектива на фокусном расстоянии, использованном для создания фотографии (значение APEX). |
imageMediaMetadata.subjectDistance | Только вывод. Расстояние до объекта съемки, в метрах. |
imageMediaMetadata.lens | Только результат съемки. Объектив, использованный для создания фотографии. |
videoMediaMetadata | Только для вывода. Метаданные о видеофайлах. Эта информация будет присутствовать только для видеофайлов. |
videoMediaMetadata.width | Только для вывода. Ширина видео в пикселях. |
videoMediaMetadata.height | Только вывод. Высота видео в пикселях. |
videoMediaMetadata.durationMillis | Только вывод. Длительность видео в миллисекундах. |
shortcutDetails | Сведения о файле ярлыка. Заполняется только для файлов ярлыков, у которых поле mimeType установлено на |
shortcutDetails.targetId | Идентификатор файла, на который указывает этот ярлык. Может быть задан только в запросах |
shortcutDetails.targetMimeType | Только для вывода. MIME-тип файла, на который указывает этот ярлык. Значение этого поля представляет собой снимок MIME-типа целевого файла, полученный при создании ярлыка. |
shortcutDetails.targetResourceKey | Только для вывода. Ресурсный ключ для целевого файла. |
resourceKey | Только для вывода. Ключ, необходимый для доступа к элементу по общей ссылке. |
linkShareMetadata | Только вывод. Подробная информация, связанная с LinkShare. Содержит сведения об URL-адресах ссылок, которые клиенты используют для перехода к этому товару. |
linkShareMetadata.securityUpdateEligible | Только вывод. Указывает, подлежит ли файл обновлению безопасности. |
linkShareMetadata.securityUpdateEnabled | Только вывод. Указывает, включено ли обновление безопасности для этого файла. |
labelInfo | Только вывод. Краткий обзор меток в файле. |
labelInfo.labels[] | Только для вывода. Набор меток в файле, запрошенный идентификаторами меток в параметре |
sha1Checksum | Только вывод. Контрольная сумма SHA1, связанная с этим файлом, если она доступна. Это поле заполняется только для файлов, содержимое которых хранится в Google Диск; оно не заполняется для редакторов документов или файлов ярлыков. |
sha256Checksum | Только вывод. Контрольная сумма SHA256, связанная с этим файлом, если она доступна. Это поле заполняется только для файлов, содержимое которых хранится в Google Диск; оно не заполняется для редакторов документов или файлов ярлыков. |
inheritedPermissionsDisabled | Отключено ли наследование прав доступа к этому файлу? Наследование прав доступа включено по умолчанию. |
Ограничение контента
Ограничение на доступ к содержимому файла.
| JSON-представление |
|---|
{
"readOnly": boolean,
"reason": string,
"type": string,
"restrictingUser": {
object ( |
| Поля | |
|---|---|
readOnly | Указывается, доступно ли содержимое файла только для чтения. Если файл доступен только для чтения, добавление новых версий файла, добавление или изменение комментариев, а также изменение заголовка файла не допускается. |
reason | Причина ограничения доступа к содержимому файла. Это можно изменить только в запросах, в которых также установлен |
type | Только вывод. Тип ограничения контента. В настоящее время единственное возможное значение — |
restrictingUser | Только для вывода. Пользователь, установивший ограничение на контент. Заполняется только в том случае, если |
restrictionDate | Только для вывода. Время, когда было установлено ограничение на содержимое (отформатированная метка времени RFC 3339). Заполняется только в том случае, если |
ownerRestricted | Ограничение на содержимое может быть изменено или снято только пользователем, являющимся владельцем файла. Для файлов на общих дисках любой пользователь с правами |
systemRestricted | Только вывод. Указывается, было ли ограничение на контент применено системой, например, из-за электронной подписи. Пользователи не могут изменять или удалять системные ограничения на контент. |
Методы | |
|---|---|
| Создает копию указанного файла. |
| Безвозвратно удаляет файл, принадлежащий пользователю, не перемещая его в корзину. |
| Удаляет безвозвратно все файлы пользователя из корзины. |
| Экспортирует документ Google Workspace в запрошенный MIME-тип и возвращает экспортированное содержимое в байтах. |
| Генерирует набор идентификаторов файлов, которые можно указывать в запросах на вставку или копирование. |
| Получает метаданные или содержимое файла по идентификатору. |
| Вставляет новый файл. |
| Отображает список файлов пользователя. |
| Выводит список меток в файле. |
| Изменяет набор меток, применяемых к файлу. |
| Обновляет метаданные и/или содержимое файла. |
| Установите время обновления файла равным текущему времени сервера. |
| Перемещает файл в корзину. |
| Восстанавливает файл из корзины. |
| Обновляет метаданные, содержимое файла или и то, и другое. |
| Подписывается на изменения файла. |