REST Resource: files

Ресурс: Файл

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

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

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

string

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

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

Если это не указано в запросе на создание, файл помещается непосредственно в папку «Мой диск» пользователя. Если это не указано в запросе на копирование, файл наследует любого доступного родительского файла от исходного. Запросы на обновление должны использовать параметры 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 Drive не сможет сгенерировать стандартную миниатюру.

contentHints.thumbnail.image

string ( bytes format)

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

Строка, закодированная в формате Base64.

contentHints.thumbnail.mimeType

string

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

writersCanShare

boolean

Позволяет ли пользователям с правами только writer изменять права доступа к файлу. Эта опция не заполняется для элементов на общих дисках.

viewedByMe

boolean

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

mimeType

string

MIME-тип файла.

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

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

shared

boolean

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

lastModifyingUser

object ( User )

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

headRevisionId

string

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

sharingUser

object ( User )

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

webContentLink

string

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

size

string ( int64 format)

Только для вывода. Размер в байтах для больших двоичных объектов и файлов редактора 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 дата-время ).

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

Output only. The full file extension extracted from the name field. May contain multiple concatenated extensions, such as "tar.gz". This is only available for files with binary content in Google Drive.

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

isAppAuthorized

boolean

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

teamDriveId
(deprecated)

string

Устарело: Только вывод. Используйте driveId вместо него.

capabilities

object

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

capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

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

capabilities.canMoveChildrenOutOfDrive

boolean

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

capabilities.canReadDrive

boolean

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

capabilities.canEdit

boolean

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

capabilities.canCopy

boolean

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

capabilities.canComment

boolean

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

capabilities.canAddChildren

boolean

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

capabilities.canDelete

boolean

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

capabilities.canDownload

boolean

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

capabilities.canListChildren

boolean

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

capabilities.canRemoveChildren

boolean

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

capabilities.canRename

boolean

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

capabilities.canTrash

boolean

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

capabilities.canReadRevisions

boolean

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

capabilities.canReadTeamDrive
(deprecated)

boolean

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

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

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

capabilities.canChangeCopyRequiresWriterPermission

boolean

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

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

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

capabilities.canUntrash

boolean

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

capabilities.canModifyContent

boolean

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

capabilities.canMoveItemWithinTeamDrive
(deprecated)

boolean

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

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

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

capabilities.canDeleteChildren

boolean

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

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

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

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

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

capabilities.canTrashChildren

boolean

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

capabilities.canMoveItemOutOfDrive

boolean

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

capabilities.canAddMyDriveParent

boolean

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

capabilities.canRemoveMyDriveParent

boolean

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

capabilities.canMoveItemWithinDrive

boolean

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

capabilities.canShare

boolean

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

capabilities.canMoveChildrenWithinDrive

boolean

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

capabilities.canModifyContentRestriction
(deprecated)

boolean

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

capabilities.canAddFolderFromAnotherDrive

boolean

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

capabilities.canChangeSecurityUpdateEnabled

boolean

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

capabilities.canAcceptOwnership

boolean

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

capabilities.canReadLabels

boolean

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

capabilities.canModifyLabels

boolean

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

capabilities.canModifyEditorContentRestriction

boolean

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

capabilities.canModifyOwnerContentRestriction

boolean

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

capabilities.canRemoveContentRestriction

boolean

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

capabilities.canDisableInheritedPermissions

boolean

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

capabilities.canEnableInheritedPermissions

boolean

Возможность повторного включения унаследованных разрешений пользователем.

capabilities.canChangeItemDownloadRestriction

boolean

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

hasAugmentedPermissions

boolean

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

trashingUser

object ( User )

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

thumbnailVersion

string ( int64 format)

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

trashedTime

string

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

modifiedByMe

boolean

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

imageMediaMetadata

object

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

imageMediaMetadata.flashUsed

boolean

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

imageMediaMetadata.meteringMode

string

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

imageMediaMetadata.sensor

string

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

imageMediaMetadata.exposureMode

string

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

imageMediaMetadata.colorSpace

string

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

imageMediaMetadata.whiteBalance

string

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

imageMediaMetadata.width

integer

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

imageMediaMetadata.height

integer

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

imageMediaMetadata.location

object

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

imageMediaMetadata.location.latitude

number

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

imageMediaMetadata.location.longitude

number

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

imageMediaMetadata.location.altitude

number

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

imageMediaMetadata.rotation

integer

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

imageMediaMetadata.time

string

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

imageMediaMetadata.cameraMake

string

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

imageMediaMetadata.cameraModel

string

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

imageMediaMetadata.exposureTime

number

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

imageMediaMetadata.aperture

number

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

imageMediaMetadata.focalLength

number

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

imageMediaMetadata.isoSpeed

integer

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

imageMediaMetadata.exposureBias

number

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

imageMediaMetadata.maxApertureValue

number

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

imageMediaMetadata.subjectDistance

integer

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

imageMediaMetadata.lens

string

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

videoMediaMetadata

object

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

videoMediaMetadata.width

integer

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

videoMediaMetadata.height

integer

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

videoMediaMetadata.durationMillis

string ( int64 format)

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

shortcutDetails

object

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

shortcutDetails.targetId

string

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

shortcutDetails.targetMimeType

string

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

shortcutDetails.targetResourceKey

string

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

resourceKey

string

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

linkShareMetadata.securityUpdateEligible

boolean

Только вывод. Указывает, подлежит ли файл обновлению безопасности.

linkShareMetadata.securityUpdateEnabled

boolean

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

labelInfo

object

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

labelInfo.labels[]

object ( Label )

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

sha1Checksum

string

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

sha256Checksum

string

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

inheritedPermissionsDisabled

boolean

Отключено ли наследование прав доступа к этому файлу? Наследование прав доступа включено по умолчанию.

downloadRestrictions

object ( DownloadRestrictionsMetadata )

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

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

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

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

boolean

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

reason

string

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

type

string

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

restrictingUser

object ( User )

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

restrictionTime

string

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

ownerRestricted

boolean

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

systemRestricted

boolean

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

DownloadRestrictionsMetadata

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

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

Методы

copy

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

create

Создает файл.

delete

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

download

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

emptyTrash

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

export

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

generateIds

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

get

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

list

Отображает список файлов пользователя.

listLabels

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

modifyLabels

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

update

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

watch

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