Эта страница переведена с помощью Cloud Translation API.

REST Resource: files

Ресурс: Файл
Методы

Ресурс: Файл

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

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

JSON-представление

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`) } }

{
  "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)
  }
}

Поля
`exportLinks`	`map (key: string, value: string)` Только вывод. Ссылки для экспорта файлов Docs Editors в определённые форматы. Объект, содержащий список пар `"key": value` . Пример: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }` .
`parents[]`	`string` Идентификатор родительской папки, содержащей файл. Файл может иметь только одну родительскую папку; указание нескольких родительских папок не поддерживается. Если в запросе на создание не указано иное, файл помещается непосредственно в папку «Мой диск» пользователя. Если в запросе на копирование не указано иное, файл наследует любой обнаруживаемый родительский элемент исходного файла. В запросах на обновление необходимо использовать параметры `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.0. Для получения приватных свойств нельзя использовать ключ 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, загруженный контент импортируется, если это возможно. Поддерживаемые форматы импорта опубликованы в разделе `about` проекте».
`thumbnailLink`	`string` Только вывод. Краткосрочная ссылка на миниатюру файла, если она доступна. Обычно она существует порядка нескольких часов. Не предназначена для прямого использования в веб-приложениях из-за политик Cross-Origin Resource Sharing (CORS) . Рекомендуется использовать прокси-сервер. Заполняется только в том случае, если запрашивающее приложение имеет доступ к содержимому файла. Если файл не находится в открытом доступе, URL-адрес, возвращаемый в `files.thumbnailLink` , необходимо получить с помощью запроса с учётными данными.
`iconLink`	`string` Только вывод. Статическая, неаутентифицированная ссылка на значок файла.
`shared`	`boolean` Только вывод. Был ли файл предоставлен в общий доступ. Не заполняется для объектов на общих дисках.
`lastModifyingUser`	`object ( User )` Только вывод. Последний пользователь, изменивший файл. Это поле заполняется только в том случае, если последнее изменение было внесено вошедшим в систему пользователем.
`headRevisionId`	`string` Только вывод. Идентификатор начальной версии файла. В настоящее время эта функция доступна только для файлов с двоичным содержимым на Google Диске.
`sharingUser`	`object ( User )` Только вывод. Пользователь, предоставивший файл запрашивающему пользователю (если применимо).
`webViewLink`	`string` Только вывод. Ссылка для открытия файла в соответствующем редакторе Google или просмотрщике в браузере.
`webContentLink`	`string` Только вывод. Ссылка для загрузки содержимого файла в браузере. Доступно только для файлов с двоичным содержимым на Google Диске.
`size`	`string ( int64 format)` Только вывод. Размер в байтах для двоичных объектов (BLOB) и файлов редактора Google Workspace. Не заполняется для файлов без размера, таких как ярлыки и папки.
`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 date-time ).
`modifiedTime`	`string` Время последнего изменения файла кем-либо ( дата-время RFC 3339 ). Обратите внимание, что настройка `modifiedTime` также обновляет `modifiedByMeTime` для пользователя.
`modifiedByMeTime`	`string` Только вывод. Время последнего изменения файла пользователем ( RFC 3339 date-time ).
`viewedByMeTime`	`string` Время последнего просмотра файла пользователем ( RFC 3339 дата-время ).
`sharedWithMeTime`	`string` Только вывод. Время, когда файл был предоставлен пользователю, если применимо ( RFC 3339 date-time ).
`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`	`object` Только вывод. Подробности, связанные с LinkShare. Содержит сведения об URL-адресах ссылок, которые клиенты используют для ссылки на этот элемент.
`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 date-time ). Заполняется только при `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` Ограничено ли скачивание и копирование для писателей. Если `true` , скачивание также ограничено для читателей.

restrictedForReaders

boolean

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

restrictedForWriters

boolean

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

Методы
`copy`	Создает копию файла и применяет все запрошенные обновления с семантикой исправлений.
`create`	Создает файл.
`delete`	Навсегда удаляет файл, принадлежащий пользователю, не перемещая его в корзину.
`download`	Загружает содержимое файла.
`emptyTrash`	Навсегда удаляет все удаленные пользователем файлы.
`export`	Экспортирует документ Google Workspace в запрошенный тип MIME и возвращает экспортированное байтовое содержимое.
`generateIds`	Генерирует набор идентификаторов файлов, которые могут быть предоставлены в запросах на создание или копирование.
`get`	Получает метаданные или содержимое файла по идентификатору.
`list`	Выводит список файлов пользователя.
`listLabels`	Выводит список меток файла.
`modifyLabels`	Изменяет набор меток, примененных к файлу.
`update`	Обновляет метаданные, содержимое или и то, и другое файла.
`watch`	Подписывается на изменения в файле.

REST Resource: files

Ресурс: Файл

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

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

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

Методы

`copy`

`create`

`delete`

`download`

`emptyTrash`

`export`

`generateIds`

`get`

`list`

`listLabels`

`modifyLabels`

`update`

`watch`

REST Resource: files Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Ресурс: Файл

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

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

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

Методы

REST Resource: files