REST Resource: files

Ресурс: Файл

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

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

JSON-представление
{
  "ownerNames": [
    string
  ],
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "properties": [
    {
      object (Property)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "driveId": string,
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "hasThumbnail": boolean,
  "folderColorRgb": string,
  "id": string,
  "title": string,
  "description": string,
  "labels": {
    "viewed": boolean,
    "restricted": boolean,
    "starred": boolean,
    "hidden": boolean,
    "trashed": boolean,
    "modified": boolean
  },
  "explicitlyTrashed": boolean,
  "createdDate": string,
  "modifiedDate": string,
  "modifiedByMeDate": string,
  "lastViewedByMeDate": string,
  "markedViewedByMeDate": string,
  "sharedWithMeDate": string,
  "quotaBytesUsed": string,
  "version": string,
  "indexableText": {
    "text": string
  },
  "originalFilename": string,
  "ownedByMe": boolean,
  "canComment": boolean,
  "shareable": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeRestrictedDownload": 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)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": string,
  "thumbnail": {
    "image": string,
    "mimeType": 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,
    "date": 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
}
Поля
ownerNames[]

string

Только для вывода. Имя (имена) владельца (владельцев) этого файла. Не заполняется для файлов на общих дисках.

parents[]

object ( ParentReference )

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

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

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

owners[]

object ( User )

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

properties[]

object ( Property )

Список объектов недвижимости.

permissions[]

object ( Permission )

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

spaces[]

string

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

permissionIds[]

string

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

contentRestrictions[]

object ( ContentRestriction )

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

kind

string

Только вывод. Тип файла. Это всегда drive#file .

userPermission

object ( Permission )

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

fileExtension

string

Только для вывода. Удаляется последний компонент поля fullFileExtension с текстом, который, по-видимому, не является частью расширения. Это поле заполняется только для файлов, содержимое которых хранится в Google Диск; оно не заполняется для редакторов документов или файлов ярлыков.

md5Checksum

string

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

lastModifyingUserName

string

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

editable
(deprecated)

boolean

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

writersCanShare

boolean

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

downloadUrl

string

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

mimeType

string

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

driveId

string

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

appDataContents

boolean

Только для вывода. Указывает, находится ли этот файл в папке «Данные приложения».

shared

boolean

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

lastModifyingUser

object ( User )

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

headRevisionId

string

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

copyable
(deprecated)

boolean

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

etag

string

Только вывод. ETag файла.

sharingUser

object ( User )

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

fileSize

string ( int64 format)

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

copyRequiresWriterPermission

boolean

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

hasThumbnail

boolean

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

folderColorRgb

string

Цвет папки указывается в виде шестнадцатеричной строки RGB, если файл является папкой или ярлыком к папке. Список поддерживаемых цветов доступен в поле folderColorPalette ресурса «О программе». Если указан неподдерживаемый цвет, он будет заменен на ближайший цвет в палитре.

id

string

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

title

string

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

description

string

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

labels

object

Группа меток для файла.

labels.viewed

boolean

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

labels.restricted
(deprecated)

boolean

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

labels.starred

boolean

Указывает, отмечен ли этот файл пользователем как «избранное».

labels.hidden
(deprecated)

boolean

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

labels.trashed

boolean

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

labels.modified

boolean

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

explicitlyTrashed

boolean

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

createdDate

string

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

modifiedDate

string

Последнее изменение этого файла кем-либо (отформатированная метка времени RFC 3339). Изменить его при обновлении можно только при наличии параметра setModifiedDate.

modifiedByMeDate

string

Только для вывода. Последнее изменение этого файла пользователем (отформатированная метка времени RFC 3339). Обратите внимание, что установка modifiedDate также обновит дату modifiedByMe для пользователя, установившего эту дату.

lastViewedByMeDate

string

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

markedViewedByMeDate
(deprecated)

string

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

sharedWithMeDate

string

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

quotaBytesUsed

string ( int64 format)

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

version

string ( int64 format)

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

indexableText

object

Индексируемые текстовые атрибуты для файла (могут только записываться)

indexableText.text

string

Текст, подлежащий индексации для этого файла.

originalFilename

string

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

ownedByMe

boolean

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

canComment
(deprecated)

boolean

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

shareable
(deprecated)

boolean

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

fullFileExtension

string

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

isAppAuthorized

boolean

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

teamDriveId
(deprecated)

string

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

capabilities

object

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

capabilities.canChangeRestrictedDownload
(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

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

hasAugmentedPermissions

boolean

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

trashingUser

object ( User )

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

canReadRevisions
(deprecated)

boolean

Только вывод. Устарело: используйте capabilities/canReadRevisions вместо этого.

thumbnailVersion

string ( int64 format)

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

trashedDate

string

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

thumbnail

object

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

thumbnail.image

string ( bytes format)

Безопасные для использования в URL-адресах байты изображения-миниатюры, закодированные в Base64. Они должны соответствовать разделу 5 RFC 4648.

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

thumbnail.mimeType

string

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

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.date

string

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

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.insert .

shortcutDetails.targetId

string

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

shortcutDetails.targetMimeType

string

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

shortcutDetails.targetResourceKey

string

Только для вывода. Ресурсный ключ для целевого файла.

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

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

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

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

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

boolean

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

reason

string

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

type

string

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

restrictingUser

object ( User )

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

restrictionDate

string

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

ownerRestricted

boolean

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

systemRestricted

boolean

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

Методы

copy

Создает копию указанного файла.

delete

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

emptyTrash

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

export

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

generateIds

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

get

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

insert

Вставляет новый файл.

list

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

listLabels

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

modifyLabels

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

patch

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

touch

Установите время обновления файла равным текущему времени сервера.

trash

Перемещает файл в корзину.

untrash

Восстанавливает файл из корзины.

update

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

watch

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