REST Resource: files

Ресурс: Файл

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

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

Представление JSON
{
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "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,
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "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
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "permissionIds": [
    string
  ],
  "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
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string
}
Поля
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, загружаемый контент импортируется, если это возможно. Поддерживаемые форматы импорта опубликованы в ресурсе О программе.

parents[]

string

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

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

shared

boolean

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

lastModifyingUser

object ( User )

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

owners[]

object ( User )

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

headRevisionId

string

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

sharingUser

object ( User )

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

webContentLink

string

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

size

string ( int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

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

permissions[]

object ( Permission )

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

hasThumbnail

boolean

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

spaces[]

string

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

folderColorRgb

string

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

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

id

string

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

name

string

Имя файла. Это не обязательно уникально внутри папки. Обратите внимание, что для неизменяемых элементов, таких как папки верхнего уровня общих дисков, корневая папка My Drive и папка Application Data, имя является постоянным.

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 , однако оно не очищается, если новое имя не содержит допустимого расширения.

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" } .

isAppAuthorized

boolean

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

teamDriveId
(deprecated)

string

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

capabilities

object

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

capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

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

capabilities.canMoveChildrenOutOfDrive

boolean

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

capabilities.canReadDrive

boolean

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

capabilities.canEdit

boolean

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

capabilities.canCopy

boolean

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

capabilities.canComment

boolean

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

capabilities.canAddChildren

boolean

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

capabilities.canDelete

boolean

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

capabilities.canDownload

boolean

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

capabilities.canListChildren

boolean

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

capabilities.canRemoveChildren

boolean

Только вывод. Может ли текущий пользователь удалять дочерние элементы из этой папки. Это всегда ложно, если элемент не является папкой. Для папки на общем диске используйте вместо этого 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

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

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

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

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

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

capabilities.canTrashChildren

boolean

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

capabilities.canMoveItemOutOfDrive

boolean

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

capabilities.canAddMyDriveParent

boolean

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

capabilities.canRemoveMyDriveParent

boolean

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

capabilities.canMoveItemWithinDrive

boolean

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

capabilities.canShare

boolean

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

capabilities.canMoveChildrenWithinDrive

boolean

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

capabilities.canModifyContentRestriction
(deprecated)

boolean

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

capabilities.canAddFolderFromAnotherDrive

boolean

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

capabilities.canChangeSecurityUpdateEnabled

boolean

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

capabilities.canAcceptOwnership

boolean

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

capabilities.canReadLabels

boolean

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

capabilities.canModifyLabels

boolean

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

capabilities.canModifyEditorContentRestriction

boolean

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

capabilities.canModifyOwnerContentRestriction

boolean

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

capabilities.canRemoveContentRestriction

boolean

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

hasAugmentedPermissions

boolean

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

trashingUser

object ( User )

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

thumbnailVersion

string ( int64 format)

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

trashedTime

string

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

modifiedByMe

boolean

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

permissionIds[]

string

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

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

Только вывод. Наименьшее число f объектива на фокусном расстоянии, используемом для создания фотографии (значение 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 .

shortcutDetails.targetId

string

Идентификатор файла, на который указывает этот ярлык.

shortcutDetails.targetMimeType

string

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

shortcutDetails.targetResourceKey

string

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

contentRestrictions[]

object ( ContentRestriction )

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

resourceKey

string

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

linkShareMetadata.securityUpdateEligible

boolean

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

linkShareMetadata.securityUpdateEnabled

boolean

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

labelInfo

object

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

labelInfo.labels[]

object ( Label )

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

sha1Checksum

string

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

sha256Checksum

string

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

ContentRestriction

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

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

boolean

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

reason

string

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

type

string

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

restrictingUser

object ( User )

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

restrictionTime

string

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

ownerRestricted

boolean

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

Методы

copy

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

create

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

delete

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

emptyTrash

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

export

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

generateIds

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

get

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

list

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

listLabels

 Список меток в файле.

modifyLabels

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

update

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

watch

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