REST Resource: files

Ресурс: Файл

Метаданные файла.

Некоторые методы ресурсов (например, files.update ) требуют fileId . Используйте метод files.list для получения идентификатора файла.

JSON-представление 
{
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "hasThumbnail": boolean,
  "folderColorRgb": string,
  "id": string,
  "name": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "createdTime": string,
  "modifiedTime": string,
  "modifiedByMeTime": string,
  "viewedByMeTime": string,
  "sharedWithMeTime": string,
  "quotaBytesUsed": string,
  "version": string,
  "originalFilename": string,
  "ownedByMe": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean,
    "canChangeItemDownloadRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "time": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean,
  "downloadRestrictions": {
    object (DownloadRestrictionsMetadata)
  }
}
Поля
parents[]

string

Идентификатор родительской папки, содержащей файл.

Файл может иметь только одну родительскую папку; указание нескольких родительских папок не поддерживается.

Если не указано в запросе на создание, файл помещается непосредственно в папку «Мой диск» пользователя. Если не указано в запросе на копирование, файл наследует любой обнаруживаемый родительский элемент исходного файла. Запросы files.update должны использовать параметры addParents и removeParents для изменения списка родительских элементов.

owners[]

object ( User )

Только выходные данные. Владелец этого файла. Только некоторые устаревшие файлы могут иметь более одного владельца. Это поле не заполняется для объектов на общих дисках.

permissions[]

object ( Permission )

Только вывод. Полный список разрешений для файла. Доступно только в том случае, если запрашивающий пользователь может предоставить общий доступ к файлу. Не заполняется для объектов на общих дисках.

spaces[]

string

Только вывод. Список пространств, содержащих файл. В настоящее время поддерживаются значения «drive», «appDataFolder» и «photos».

properties

map (key: string, value: value ( Value format))

Коллекция произвольных пар «ключ-значение», которые видны всем приложениям.

Записи с нулевыми значениями удаляются в запросах на обновление и копирование.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

appProperties

map (key: string, value: value ( Value format))

Коллекция произвольных пар «ключ-значение», которые являются конфиденциальными для запрашивающего приложения.

Записи с нулевыми значениями удаляются в запросах на обновление и копирование.

Эти свойства можно получить только с помощью аутентифицированного запроса. В аутентифицированном запросе используется токен доступа, полученный с помощью идентификатора клиента OAuth 2. Ключ API нельзя использовать для получения приватных свойств.

Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

permissionIds[]

string

Только вывод. файлы.список идентификаторов разрешений для пользователей, имеющих доступ к этому файлу.

contentRestrictions[]

object ( ContentRestriction )

Ограничения доступа к содержимому файла. Заполняется только при наличии такого ограничения.

kind

string

Только вывод. Определяет тип ресурса. Значение: фиксированная строка "drive#file" .

driveId

string

Только вывод. Идентификатор общего диска, на котором находится файл. Заполняется только для элементов на общих дисках.

fileExtension

string

Только вывод. Последний компонент fullFileExtension . Доступно только для файлов с двоичным содержимым на Google Диске.

copyRequiresWriterPermission

boolean

Следует ли отключить возможность копирования, печати или загрузки этого файла для читателей и комментаторов.

md5Checksum

string

Только вывод. Контрольная сумма MD5 для содержимого файла. Применимо только к файлам с двоичным содержимым на Google Диске.

contentHints

object

Дополнительная информация о содержимом файла. Эти поля никогда не заполняются в ответах.

contentHints.indexableText

string

Текст, индексируемый для файла, для улучшения полнотекстовых запросов. Длина ограничена 128 КБ и может содержать элементы HTML.

contentHints.thumbnail

object

Миниатюра файла. Будет использоваться только в том случае, если Google Диск не сможет создать стандартную миниатюру.

contentHints.thumbnail.image

string ( bytes format)

Данные миниатюры закодированы с помощью безопасного для URL Base64 (RFC 4648, раздел 5).

Строка в кодировке base64.

contentHints.thumbnail.mimeType

string

Тип MIME миниатюры.

writersCanShare

boolean

Могут ли пользователи, имеющие только право writer , изменять разрешения файла. Не заполняется для объектов на общих дисках.

viewedByMe

boolean

Только вывод. Был ли файл просмотрен этим пользователем.

mimeType

string

MIME-тип файла.

Если значение не указано, Google Диск автоматически определяет подходящее значение из загруженного контента. Значение нельзя изменить, пока не будет загружена новая версия.

Если файл создан с MIME-типом Google Doc, загруженный контент импортируется, если это возможно. Поддерживаемые форматы импорта опубликованы в разделе «О проекте».

shared

boolean

Только вывод. Был ли файл предоставлен в общий доступ. Не заполняется для объектов на общих дисках.

lastModifyingUser

object ( User )

Только вывод. Последний пользователь, изменивший файл. Это поле заполняется только в том случае, если последнее изменение было внесено вошедшим в систему пользователем.

headRevisionId

string

Только вывод. Идентификатор начальной версии файла. В настоящее время эта функция доступна только для файлов с двоичным содержимым на Google Диске.

sharingUser

object ( User )

Только вывод. Пользователь, предоставивший файл запрашивающему пользователю (если применимо).

webContentLink

string

Только вывод. Ссылка для загрузки содержимого файла в браузере. Доступно только для файлов с двоичным содержимым на Google Диске.

size

string ( int64 format)

Только вывод. Размер в байтах для двоичных объектов (BLOB) и файлов редактора собственной разработки. Не заполняется для файлов без размера, таких как ярлыки и папки.

viewersCanCopyContent
(deprecated)

boolean

Устарело: вместо этого используйте copyRequiresWriterPermission .

hasThumbnail

boolean

Только вывод. Есть ли у этого файла миниатюра. Это не указывает, есть ли у запрашивающего приложения доступ к миниатюре. Чтобы проверить доступ, проверьте наличие поля thumbnailLink.

folderColorRgb

string

Цвет папки или ярлыка папки в виде шестнадцатеричной строки RGB. Поддерживаемые цвета указаны в поле folderColorPalette ресурса About.

Если указан неподдерживаемый цвет, вместо него будет использоваться ближайший цвет в палитре.

id

string

Идентификатор файла.

name

string

Имя файла. Оно не обязательно уникально в пределах папки. Обратите внимание, что для неизменяемых элементов, таких как папки верхнего уровня общих дисков, корневая папка «Мой диск» и папка «Данные приложения», имя является постоянным.

description

string

Краткое описание файла.

starred

boolean

Отметил ли пользователь файл звездочкой.

trashed

boolean

Был ли файл удалён в корзину, как явно, так и из родительской папки, удалённой в корзину. Только владелец может отправить файл в корзину, и другие пользователи не могут видеть файлы в корзине владельца.

explicitlyTrashed

boolean

Только вывод. Был ли файл явно удалён, а не рекурсивно удалён из родительской папки.

createdTime

string

Время создания файла (дата-время RFC 3339).

modifiedTime

string

Время последнего изменения файла кем-либо (дата-время RFC 3339).

Обратите внимание, что настройка modifiedTime также обновляет modifiedByMeTime для пользователя.

modifiedByMeTime

string

Только вывод. Время последнего изменения файла пользователем (дата и время RFC 3339).

viewedByMeTime

string

Время последнего просмотра файла пользователем (дата-время RFC 3339).

sharedWithMeTime

string

Только вывод. Время предоставления файла пользователю, если применимо (дата-время RFC 3339).

quotaBytesUsed

string ( int64 format)

Только вывод. Количество байт квоты хранилища, используемое файлом. Включает как начальную версию, так и предыдущие версии с включённым параметром keepForever .

version

string ( int64 format)

Только вывод. Монотонно увеличивающийся номер версии файла. Отражает все изменения, внесённые в файл на сервере, даже те, которые не видны пользователю.

originalFilename

string

Исходное имя файла загруженного контента (если доступно) или исходное значение поля name . Доступно только для файлов с двоичным контентом на Google Диске.

ownedByMe

boolean

Только вывод. Является ли файл владельцем пользователя. Не заполняется для объектов на общих дисках.

fullFileExtension

string

Только вывод. Полное расширение файла, извлечённое из поля name . Может содержать несколько объединённых расширений, например, «tar.gz». Доступно только для файлов с двоичным содержимым на Google Диске.

Оно автоматически обновляется при изменении поля name , однако не очищается, если новое имя не содержит допустимого расширения.

isAppAuthorized

boolean

Только вывод. Был ли файл создан или открыт запрашивающим приложением.

teamDriveId
(deprecated)

string

Устарело: только вывод. Вместо этого используйте driveId .

capabilities

object

Только вывод. Возможности текущего пользователя для этого файла. Каждая возможность соответствует детальному действию, которое может выполнить пользователь.

capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

Устаревшее: только вывод.

capabilities.canMoveChildrenOutOfDrive

boolean

Только вывод. Может ли текущий пользователь перемещать дочерние элементы этой папки за пределы общего диска. Значение false, если элемент не является папкой. Заполняется только для элементов на общих дисках.

capabilities.canReadDrive

boolean

Только вывод. Может ли текущий пользователь читать общий диск, к которому принадлежит этот файл. Заполняется только для элементов на общих дисках.

capabilities.canEdit

boolean

Только вывод. Может ли текущий пользователь редактировать этот файл. Другие факторы могут ограничивать типы изменений, которые пользователь может вносить в файл. Например, см. canChangeCopyRequiresWriterPermission или canModifyContent .

capabilities.canCopy

boolean

Только вывод. Может ли текущий пользователь копировать этот файл. Для элемента на общем диске: может ли текущий пользователь копировать потомков этого элемента, не являющихся папками, или сам элемент, если он не является папкой.

capabilities.canComment

boolean

Только вывод. Может ли текущий пользователь комментировать этот файл.

capabilities.canAddChildren

boolean

Только вывод. Может ли текущий пользователь добавлять дочерние элементы в эту папку. Всегда имеет значение false, если элемент не является папкой.

capabilities.canDelete

boolean

Только вывод. Может ли текущий пользователь удалить этот файл.

capabilities.canDownload

boolean

Только вывод. Может ли текущий пользователь загрузить этот файл.

capabilities.canListChildren

boolean

Только вывод. Может ли текущий пользователь вывести список дочерних элементов этой папки. Всегда имеет значение false, если элемент не является папкой.

capabilities.canRemoveChildren

boolean

Только вывод. Может ли текущий пользователь удалять дочерние элементы из этой папки. Значение всегда равно false, если элемент не является папкой. Для папки на общем диске используйте canDeleteChildren или canTrashChildren .

capabilities.canRename

boolean

Только вывод. Может ли текущий пользователь переименовать этот файл.

capabilities.canTrash

boolean

Только вывод. Может ли текущий пользователь переместить этот файл в корзину.

capabilities.canReadRevisions

boolean

Только вывод. Может ли текущий пользователь читать ресурс версий этого файла. Для элемента общего диска — можно ли читать версии потомков этого элемента, не являющихся папками, или сам этот элемент, если он не является папкой.

capabilities.canReadTeamDrive
(deprecated)

boolean

Устарело: только вывод. Вместо этого используйте canReadDrive .

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Устарело: только вывод. Вместо этого используйте canMoveItemWithinDrive или canMoveItemOutOfDrive .

capabilities.canChangeCopyRequiresWriterPermission

boolean

Только вывод. Может ли текущий пользователь изменить ограничение copyRequiresWriterPermission для этого файла.

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

Устарело: только вывод. Вместо этого используйте canMoveItemOutOfDrive .

capabilities.canUntrash

boolean

Только вывод. Может ли текущий пользователь восстановить этот файл из корзины.

capabilities.canModifyContent

boolean

Только вывод. Может ли текущий пользователь изменять содержимое этого файла.

capabilities.canMoveItemWithinTeamDrive
(deprecated)

boolean

Устарело: только вывод. Вместо этого используйте canMoveItemWithinDrive .

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Устарело: только вывод. Вместо этого используйте canMoveItemOutOfDrive .

capabilities.canDeleteChildren

boolean

Только вывод. Может ли текущий пользователь удалять дочерние элементы этой папки. Значение false, если элемент не является папкой. Заполняется только для элементов на общих дисках.

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

Устарело: только вывод. Вместо этого используйте canMoveChildrenOutOfDrive .

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Устарело: только вывод. Вместо этого используйте canMoveChildrenWithinDrive .

capabilities.canTrashChildren

boolean

Только вывод. Может ли текущий пользователь удалять дочерние элементы этой папки. Значение false, если элемент не является папкой. Заполняется только для элементов на общих дисках.

capabilities.canMoveItemOutOfDrive

boolean

Только вывод. Может ли текущий пользователь переместить этот элемент за пределы этого диска, изменив его родительский элемент. Обратите внимание, что запрос на изменение родительского элемента может по-прежнему завершаться ошибкой в зависимости от добавляемого нового родительского элемента.

capabilities.canAddMyDriveParent

boolean

Только вывод. Может ли текущий пользователь добавить родительский элемент для элемента, не удаляя существующий родительский элемент в том же запросе. Не заполняется для файлов на общем диске.

capabilities.canRemoveMyDriveParent

boolean

Только вывод. Может ли текущий пользователь удалить родительский элемент из элемента, не добавляя другой родительский элемент в том же запросе. Не заполняется для файлов на общем диске.

capabilities.canMoveItemWithinDrive

boolean

Только вывод. Может ли текущий пользователь перемещать этот элемент в пределах этого диска. Обратите внимание, что запрос на изменение родительского элемента может по-прежнему завершаться ошибкой в зависимости от добавляемого и удаляемого родительского элемента.

capabilities.canShare

boolean

Только вывод. Может ли текущий пользователь изменять настройки общего доступа к этому файлу.

capabilities.canMoveChildrenWithinDrive

boolean

Только вывод. Может ли текущий пользователь перемещать дочерние элементы этой папки в пределах этого диска. Значение false, если элемент не является папкой. Обратите внимание, что запрос на перемещение дочернего элемента может по-прежнему завершаться ошибкой в зависимости от уровня доступа текущего пользователя к дочернему элементу и к целевой папке.

capabilities.canModifyContentRestriction
(deprecated)

boolean

Устарело: только вывод. Используйте один из методов canModifyEditorContentRestriction , canModifyOwnerContentRestriction или canRemoveContentRestriction .

capabilities.canAddFolderFromAnotherDrive

boolean

Только вывод. Может ли текущий пользователь добавлять папку с другого диска (другого общего диска или из раздела «Мой диск») в эту папку. Значение false, если элемент не является папкой. Заполняется только для элементов на общих дисках.

capabilities.canChangeSecurityUpdateEnabled

boolean

Только вывод. Может ли текущий пользователь изменять поле securityUpdateEnabled в метаданных ссылки общего доступа.

capabilities.canAcceptOwnership

boolean

Только вывод. Является ли текущий пользователь ожидающим владельцем файла. Не заполняется для файлов на общем диске.

capabilities.canReadLabels

boolean

Только вывод. Может ли текущий пользователь читать метки в файле.

capabilities.canModifyLabels

boolean

Только вывод. Может ли текущий пользователь изменять метки в файле.

capabilities.canModifyEditorContentRestriction

boolean

Только вывод. Может ли текущий пользователь добавлять или изменять ограничения на содержимое файла, доступные только редактору.

capabilities.canModifyOwnerContentRestriction

boolean

Только вывод. Может ли текущий пользователь добавлять или изменять ограничения на контент, установленные владельцем.

capabilities.canRemoveContentRestriction

boolean

Только вывод. Есть ли ограничения на содержимое файла, которые может снять текущий пользователь.

capabilities.canDisableInheritedPermissions

boolean

Может ли пользователь отключить унаследованные разрешения.

capabilities.canEnableInheritedPermissions

boolean

Может ли пользователь повторно включить унаследованные разрешения.

capabilities.canChangeItemDownloadRestriction

boolean

Только вывод. Может ли текущий пользователь изменить владельца или установленные организатором ограничения на загрузку файла.

hasAugmentedPermissions

boolean

Только вывод. Есть ли разрешения непосредственно на этот файл. Это поле заполняется только для объектов на общих дисках.

trashingUser

object ( User )

Только вывод. Если файл был явно удалён, укажите пользователя, который его удалил. Заполняется только для объектов на общих дисках.

thumbnailVersion

string ( int64 format)

Только вывод. Версия миниатюры для использования при аннулировании кэша миниатюр.

trashedTime

string

Только вывод. Время удаления элемента (дата-время RFC 3339). Заполняется только для элементов на общих дисках.

modifiedByMe

boolean

Только вывод. Был ли файл изменён этим пользователем.

imageMediaMetadata

object

Только вывод. Дополнительные метаданные о медиа-файлах, если доступны.

imageMediaMetadata.flashUsed

boolean

Только вывод. Использовалась ли вспышка при создании фотографии.

imageMediaMetadata.meteringMode

string

Только вывод. Режим замера экспозиции, использованный при создании фотографии.

imageMediaMetadata.sensor

string

Только вывод. Тип сенсора, использованного для создания фотографии.

imageMediaMetadata.exposureMode

string

Только вывод. Режим экспозиции, использованный для создания фотографии.

imageMediaMetadata.colorSpace

string

Только вывод. Цветовое пространство фотографии.

imageMediaMetadata.whiteBalance

string

Только вывод. Режим баланса белого, использованный при создании фотографии.

imageMediaMetadata.width

integer

Только вывод. Ширина изображения в пикселях.

imageMediaMetadata.height

integer

Только вывод. Высота изображения в пикселях.

imageMediaMetadata.location

object

Только вывод. Информация о географическом местоположении, хранящаяся в изображении.

imageMediaMetadata.location.latitude

number

Только вывод. Широта, сохранённая в изображении.

imageMediaMetadata.location.longitude

number

Только вывод. Долгота, сохранённая в изображении.

imageMediaMetadata.location.altitude

number

Только вывод. Высота, сохранённая на изображении.

imageMediaMetadata.rotation

integer

Только вывод. Количество поворотов по часовой стрелке на 90 градусов относительно исходной ориентации изображения.

imageMediaMetadata.time

string

Только вывод. Дата и время съёмки фотографии (EXIF DateTime).

imageMediaMetadata.cameraMake

string

Только вывод. Марка камеры, использованной для создания фотографии.

imageMediaMetadata.cameraModel

string

Только вывод. Модель камеры, использованной для создания фотографии.

imageMediaMetadata.exposureTime

number

Только вывод. Длительность экспозиции в секундах.

imageMediaMetadata.aperture

number

Только вывод. Диафрагма, использованная для создания фотографии (число f).

imageMediaMetadata.focalLength

number

Только вывод. Фокусное расстояние, использованное для создания фотографии, в миллиметрах.

imageMediaMetadata.isoSpeed

integer

Только вывод. Чувствительность ISO, использованная при создании фотографии.

imageMediaMetadata.exposureBias

number

Только вывод. Смещение экспозиции фотографии (значение APEX).

imageMediaMetadata.maxApertureValue

number

Только вывод. Наименьшее диафрагменное число объектива при фокусном расстоянии, использованном для создания фотографии (значение APEX).

imageMediaMetadata.subjectDistance

integer

Только вывод. Расстояние до объекта съёмки в метрах.

imageMediaMetadata.lens

string

Только вывод. Объектив, использованный для создания фотографии.

videoMediaMetadata

object

Только вывод. Дополнительные метаданные о видеоматериалах. Они могут быть недоступны сразу после загрузки.

videoMediaMetadata.width

integer

Только вывод. Ширина видео в пикселях.

videoMediaMetadata.height

integer

Только вывод. Высота видео в пикселях.

videoMediaMetadata.durationMillis

string ( int64 format)

Только вывод. Длительность видео в миллисекундах.

shortcutDetails

object

Сведения о файле ярлыка. Заполняется только для файлов ярлыков, у которых поле mimeType имеет значение application/vnd.google-apps.shortcut . Может быть задано только в запросах files.create .

shortcutDetails.targetId

string

Идентификатор файла, на который указывает этот ярлык. Можно задать только в запросах files.create .

shortcutDetails.targetMimeType

string

Только вывод. MIME-тип файла, на который указывает этот ярлык. Значение этого поля представляет собой снимок MIME-типа целевого объекта, полученный при создании ярлыка.

shortcutDetails.targetResourceKey

string

Только вывод. ResourceKey для целевого файла.

resourceKey

string

Только вывод. Ключ, необходимый для доступа к элементу по общей ссылке.

linkShareMetadata.securityUpdateEligible

boolean

Только вывод. Подходит ли файл для обновления безопасности.

linkShareMetadata.securityUpdateEnabled

boolean

Только вывод. Включено ли обновление безопасности для этого файла.

labelInfo

object

Только вывод. Обзор меток в файле.

labelInfo.labels[]

object ( Label )

Только вывод. Набор меток файла, запрошенный по идентификаторам меток в параметре includeLabels . По умолчанию метки не возвращаются.

sha1Checksum

string

Только выходные данные. Контрольная сумма SHA1, связанная с этим файлом, если она доступна. Это поле заполняется только для файлов с содержимым, хранящимся на Google Диске; оно не заполняется для редакторов документов и файлов ярлыков.

sha256Checksum

string

Только выходные данные. Контрольная сумма SHA256, связанная с этим файлом, если она доступна. Это поле заполняется только для файлов с содержимым, хранящимся на Google Диске; оно не заполняется для редакторов документов и файлов ярлыков.

inheritedPermissionsDisabled

boolean

Отключены ли для этого файла унаследованные разрешения. По умолчанию унаследованные разрешения включены.

downloadRestrictions

object ( DownloadRestrictionsMetadata )

К файлу применены ограничения на загрузку.

Ограничение контента

Ограничение доступа к содержимому файла.

JSON-представление 
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionTime": string,
  "ownerRestricted": boolean,
  "systemRestricted": boolean
}
Поля
readOnly

boolean

Доступно ли содержимое файла только для чтения. Если файл доступен только для чтения, то нельзя добавлять новые версии файла, добавлять или изменять комментарии, а также изменять название файла.

reason

string

Причина, по которой содержимое файла ограничено. Изменить его можно только в запросах, которые также устанавливают readOnly=true .

type

string

Только вывод. Тип ограничения контента. В настоящее время единственное возможное значение — globalContentRestriction .

restrictingUser

object ( User )

Только вывод. Пользователь, установивший ограничение на содержимое. Заполняется только в том случае, если readOnly имеет значение true.

restrictionTime

string

Только вывод. Время установки ограничения на контент (отформатированная временная метка RFC 3339). Заполняется только в том случае, если readOnly имеет значение true.

ownerRestricted

boolean

Может ли ограничение на доступ к контенту изменять или снимать только пользователь, которому принадлежит файл? Для файлов на общих дисках любой пользователь с правами organizer может изменить или снять это ограничение.

systemRestricted

boolean

Только вывод. Было ли ограничение контента применено системой, например, из-за электронной подписи. Пользователи не могут изменять или удалять системные ограничения контента.

ЗагрузкаОграниченияМетаданные

К файлу применены ограничения на загрузку.

JSON-представление 
{
  "itemDownloadRestriction": {
    object (DownloadRestriction)
  },
  "effectiveDownloadRestrictionWithContext": {
    object (DownloadRestriction)
  }
}
Поля
itemDownloadRestriction

object ( DownloadRestriction )

Ограничение на загрузку файла, наложенное непосредственно владельцем или организатором. Оно не учитывает настройки общего диска или правила DLP.

effectiveDownloadRestrictionWithContext

object ( DownloadRestriction )

Только вывод. Действующее ограничение на загрузку, применяемое к этому файлу. Учитываются все настройки ограничений и правила DLP.

Ограничение загрузки

Ограничение на копирование и скачивание файла.

JSON-представление 
{
  "restrictedForReaders": boolean,
  "restrictedForWriters": boolean
}
Поля
restrictedForReaders

boolean

Ограничено ли скачивание и копирование для читателей.

restrictedForWriters

boolean

Ограничено ли скачивание и копирование для писателей. Если да, скачивание также ограничено для читателей.

Методы

copy

 Создает копию файла и применяет все запрошенные обновления с семантикой исправлений.

create

Создает новый файл.

delete

 Навсегда удаляет файл, принадлежащий пользователю, не перемещая его в корзину.

download

 Загружает содержимое файла.

emptyTrash

 Навсегда удаляет все удаленные пользователем файлы.

export

 Экспортирует документ Google Workspace в запрошенный тип MIME и возвращает экспортированное байтовое содержимое.

generateIds

 Генерирует набор идентификаторов файлов, которые могут быть предоставлены в запросах на создание или копирование.

get

Получает метаданные или содержимое файла по идентификатору.

list

Список файлов пользователя.

listLabels

 Выводит список меток файла.

modifyLabels

 Изменяет набор меток, примененных к файлу.

update

Обновляет метаданные и/или содержимое файла.

watch

 Подписывается на изменения в файле.