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,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": 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,
  "inheritedPermissionsDisabled": boolean
}
Поля
kind

string

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

drive Id

string

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

file Extension

string

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

copy Requires Writer Permission

boolean

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

md5 Checksum

string

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

content Hints

object

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

content Hints. indexable Text

string

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

content Hints. thumbnail

object

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

content Hints. thumbnail. image

string ( bytes format)

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

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

content Hints. thumbnail. mime Type

string

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

writers Can Share

boolean

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

viewed By Me

boolean

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

mime Type

string

MIME-тип файла.

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

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

parents[]

string

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

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

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

shared

boolean

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

last Modifying User

object ( User )

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

owners[]

object ( User )

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

head Revision Id

string

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

sharing User

object ( User )

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

web Content Link

string

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

size

string ( int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

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

permissions[]

object ( Permission )

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

has Thumbnail

boolean

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

spaces[]

string

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

folder Color Rgb

string

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

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

id

string

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

name

string

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

description

string

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

starred

boolean

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

trashed

boolean

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

explicitly Trashed

boolean

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

created Time

string

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

modified Time

string

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

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

modified By Me Time

string

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

viewed By Me Time

string

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

shared With Me Time

string

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

quota Bytes Used

string ( int64 format)

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

version

string ( int64 format)

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

original Filename

string

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

owned By Me

boolean

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

full File Extension

string

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

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

properties

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

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

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

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

app Properties

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

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

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

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

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

is App Authorized

boolean

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

teamDriveId
(deprecated)

string

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

capabilities

object

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

capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

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

capabilities. can Move Children Out Of Drive

boolean

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

capabilities. can Read Drive

boolean

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

capabilities. can Edit

boolean

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

capabilities. can Copy

boolean

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

capabilities. can Comment

boolean

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

capabilities. can Add Children

boolean

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

capabilities. can Delete

boolean

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

capabilities. can Download

boolean

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

capabilities. can List Children

boolean

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

capabilities. can Remove Children

boolean

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

capabilities. can Rename

boolean

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

capabilities. can Trash

boolean

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

capabilities. can Read Revisions

boolean

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

capabilities.canReadTeamDrive
(deprecated)

boolean

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

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

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

capabilities. can Change Copy Requires Writer Permission

boolean

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

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

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

capabilities. can Untrash

boolean

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

capabilities. can Modify Content

boolean

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

capabilities.canMoveItemWithinTeamDrive
(deprecated)

boolean

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

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

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

capabilities. can Delete Children

boolean

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

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

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

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

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

capabilities. can Trash Children

boolean

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

capabilities. can Move Item Out Of Drive

boolean

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

capabilities. can Add My Drive Parent

boolean

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

capabilities. can Remove My Drive Parent

boolean

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

capabilities. can Move Item Within Drive

boolean

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

capabilities. can Share

boolean

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

capabilities. can Move Children Within Drive

boolean

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

capabilities.canModifyContentRestriction
(deprecated)

boolean

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

capabilities. can Add Folder From Another Drive

boolean

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

capabilities. can Change Security Update Enabled

boolean

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

capabilities. can Accept Ownership

boolean

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

capabilities. can Read Labels

boolean

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

capabilities. can Modify Labels

boolean

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

capabilities. can Modify Editor Content Restriction

boolean

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

capabilities. can Modify Owner Content Restriction

boolean

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

capabilities. can Remove Content Restriction

boolean

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

capabilities. can Disable Inherited Permissions

boolean

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

capabilities. can Enable Inherited Permissions

boolean

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

has Augmented Permissions

boolean

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

trashing User

object ( User )

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

thumbnail Version

string ( int64 format)

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

trashed Time

string

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

modified By Me

boolean

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

permission Ids[]

string

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

image Media Metadata

object

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

image Media Metadata. flash Used

boolean

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

image Media Metadata. metering Mode

string

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

image Media Metadata. sensor

string

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

image Media Metadata. exposure Mode

string

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

image Media Metadata. color Space

string

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

image Media Metadata. white Balance

string

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

image Media Metadata. width

integer

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

image Media Metadata. height

integer

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

image Media Metadata. location

object

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

image Media Metadata. location. latitude

number

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

image Media Metadata. location. longitude

number

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

image Media Metadata. location. altitude

number

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

image Media Metadata. rotation

integer

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

image Media Metadata. time

string

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

image Media Metadata. camera Make

string

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

image Media Metadata. camera Model

string

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

image Media Metadata. exposure Time

number

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

image Media Metadata. aperture

number

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

image Media Metadata. focal Length

number

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

image Media Metadata. iso Speed

integer

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

image Media Metadata. exposure Bias

number

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

image Media Metadata. max Aperture Value

number

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

image Media Metadata. subject Distance

integer

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

image Media Metadata. lens

string

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

video Media Metadata

object

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

video Media Metadata. width

integer

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

video Media Metadata. height

integer

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

video Media Metadata. duration Millis

string ( int64 format)

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

shortcut Details

object

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

shortcut Details. target Id

string

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

shortcut Details. target Mime Type

string

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

shortcut Details. target Resource Key

string

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

content Restrictions[]

object ( ContentRestriction )

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

resource Key

string

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

link Share Metadata. security Update Eligible

boolean

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

link Share Metadata. security Update Enabled

boolean

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

label Info

object

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

label Info. labels[]

object ( Label )

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

sha1 Checksum

string

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

sha256 Checksum

string

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

inherited Permissions Disabled

boolean

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

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

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

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

boolean

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

reason

string

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

type

string

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

restricting User

object ( User )

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

restriction Time

string

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

owner Restricted

boolean

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

system Restricted

boolean

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

Методы

copy

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

create

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

delete

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

download

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

empty Trash

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

export

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

generate Ids

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

get

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

list

Перечисляет файлы пользователя.

list Labels

 Перечисляет метки в файле.

modify Labels

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

update

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

watch

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