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

REST Resource: files

Ресурс: Файл
- JSON-представление
  - JSON-представление
- Ограничение контента
  - JSON-представление
Методы

Ресурс: Файл

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

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

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

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
  ],
  "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` Только вывод. Имя(-ена) владельца(-ев) этого файла. Не заполняется для элементов на общих дисках.
`exportLinks`	`map (key: string, value: string)` Только вывод. Ссылки для экспорта файлов Docs Editors в определённые форматы. Объект, содержащий список пар `"key": value` . Пример: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }` .
`parents[]`	`object ( ParentReference )` Идентификатор родительской папки, содержащей файл. Файл может иметь только одну родительскую папку; указание нескольких родительских папок не поддерживается. Если в запросе на вставку не указано иное, файл помещается непосредственно в папку «Мой диск» пользователя. Если в запросе на копирование не указано иное, файл наследует любой обнаруживаемый родительский элемент исходного файла. В запросах files.update необходимо использовать параметры `addParents` и `removeParents` для изменения списка родительских элементов.
`owners[]`	`object ( User )` Только выходные данные. Владелец этого файла. Только некоторые устаревшие файлы могут иметь более одного владельца. Это поле не заполняется для объектов на общих дисках.
`openWithLinks`	`map (key: string, value: string)` Только вывод. Сопоставление идентификатора каждого приложения пользователя со ссылкой для открытия файла с помощью этого приложения. Заполняется только при использовании области drive.apps.readonly. Объект, содержащий список пар `"key": value` . Пример: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }` .
`properties[]`	`object ( Property )` Список объектов недвижимости.
`permissions[]`	`object ( Permission )` Только вывод. Список разрешений для пользователей, имеющих доступ к этому файлу. Не заполняется для элементов на общих дисках.
`spaces[]`	`string` Только вывод. Список пространств, содержащих файл. Поддерживаемые значения: `drive` , `appDataFolder` и `photos` .
`permissionIds[]`	`string` Только вывод. файлы.список идентификаторов разрешений для пользователей, имеющих доступ к этому файлу.
`contentRestrictions[]`	`object ( ContentRestriction )` Ограничения доступа к содержимому файла. Заполняется только при наличии такого ограничения.
`kind`	`string` Только вывод. Тип файла. Всегда `drive#file` .
`userPermission`	`object ( Permission )` Только вывод. Разрешения для аутентифицированного пользователя на доступ к этому файлу.
`fileExtension`	`string` Только выходные данные. Последний компонент `fullFileExtension` с конечным текстом, который, по-видимому, не является частью расширения, удалён. Это поле заполняется только для файлов с содержимым, хранящимся на Google Диске; оно не заполняется для редакторов документов и файлов ярлыков.
`md5Checksum`	`string` Только выходные данные. Контрольная сумма MD5 для содержимого этого файла. Это поле заполняется только для файлов с содержимым, хранящимся на Google Диске; оно не заполняется для редакторов документов и файлов ярлыков.
`selfLink`	`string` Только вывод. Ссылка на этот файл.
`lastModifyingUserName`	`string` Только вывод. Имя последнего пользователя, изменившего этот файл.
`editable (deprecated)`	`boolean` Этот элемент устарел! Только вывод. Устарело: вместо этого используйте `capabilities/canEdit` .
`writersCanShare`	`boolean` Могут ли авторы делиться документом с другими пользователями. Не заполняется для элементов на общих дисках.
`downloadUrl`	`string` Только вывод. Краткосрочный URL-адрес для загрузки файла. Это поле заполняется только для файлов, содержимое которых хранится на Google Диске; оно не заполняется для файлов Google Docs или файлов ярлыков.
`mimeType`	`string` MIME-тип файла. Его можно изменить только при обновлении и загрузке нового контента. Это поле можно оставить пустым, и MIME-тип будет определен на основе MIME-типа загруженного контента.
`driveId`	`string` Только вывод. Идентификатор общего диска, на котором находится файл. Заполняется только для элементов на общих дисках.
`thumbnailLink`	`string` Только вывод. Кратковременная ссылка на миниатюру файла, если она доступна. Обычно она существует порядка нескольких часов. Не предназначена для прямого использования в веб-приложениях из-за Cross-Origin Resource Sharing (CORS) . Рассмотрите возможность использования прокси-сервера. Заполняется только в том случае, если запрашивающее приложение имеет доступ к содержимому файла. Если файл не находится в публичном доступе, URL-адрес, возвращаемый в `Files.thumbnailLink` , необходимо получить с помощью запроса с учётными данными.
`appDataContents`	`boolean` Только вывод. Находится ли этот файл в папке Application Data.
`webViewLink`	`string` Только вывод. Ссылка доступна только для просмотра статических веб-ресурсов (HTML, CSS, JS и т. д.) в общедоступных папках через хостинг веб-сайтов Google Диска.
`iconLink`	`string` Только вывод. Ссылка на значок файла.
`shared`	`boolean` Только вывод. Был ли файл предоставлен в общий доступ. Не заполняется для объектов на общих дисках.
`lastModifyingUser`	`object ( User )` Только вывод. Последний пользователь, изменивший этот файл. Это поле заполняется только в том случае, если последнее изменение было внесено вошедшим в систему пользователем.
`defaultOpenWithLink`	`string` Только вывод. Ссылка для открытия этого файла в приложении пользователя по умолчанию. Заполняется только при использовании области drive.apps.readonly.
`headRevisionId`	`string` Только вывод. Идентификатор начальной версии файла. Это поле заполняется только для файлов с содержимым, хранящимся на Google Диске; оно не заполняется для редакторов документов и файлов ярлыков.
`copyable (deprecated)`	`boolean` Этот элемент устарел! Только вывод. Устарело: вместо этого используйте `capabilities/canCopy` .
`etag`	`string` Только вывод. ETag файла.
`sharingUser`	`object ( User )` Только вывод. Пользователь, который поделился элементом с текущим пользователем, если доступно.
`alternateLink`	`string` Только вывод. Ссылка для открытия файла в соответствующем редакторе или просмотрщике Google.
`embedLink`	`string` Только вывод. Ссылка для встраивания файла.
`webContentLink`	`string` Только вывод. Ссылка для загрузки содержимого файла в браузере с использованием аутентификации на основе cookie. В случаях, когда содержимое находится в открытом доступе, его можно загрузить без каких-либо учётных данных.
`fileSize`	`string ( int64 format)` Только вывод. Размер в байтах для двоичных объектов (BLOB) и файлов редактора собственной разработки. Не заполняется для файлов без размера, таких как ярлыки и папки.
`copyRequiresWriterPermission`	`boolean` Следует ли отключить возможность копирования, печати или загрузки этого файла для читателей и комментаторов.
`hasThumbnail`	`boolean` Только вывод. Есть ли у этого файла миниатюра. Это не указывает, есть ли у запрашивающего приложения доступ к миниатюре. Чтобы проверить доступ, проверьте наличие поля thumbnailLink.
`folderColorRgb`	`string` Цвет папки в шестнадцатеричном формате RGB, если файл является папкой или ярлыком папки. Список поддерживаемых цветов доступен в поле folderColorPalette ресурса About. Если указан неподдерживаемый цвет, он будет заменен на ближайший цвет в палитре.
`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). Обратите внимание, что установка modificationDate также обновит дату modificationByMe для пользователя, установившего эту дату.
`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)` Байты миниатюры, закодированные в формате Base64 и безопасные для URL. Они должны соответствовать разделу 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 для целевого файла.
`resourceKey`	`string` Только вывод. Ключ, необходимый для доступа к элементу по общей ссылке.
`linkShareMetadata`	`object` Только вывод. Подробности, связанные с LinkShare. Содержит сведения об URL-адресах ссылок, которые клиенты используют для ссылки на этот элемент.
`linkShareMetadata.securityUpdateEligible`	`boolean` Только вывод. Подходит ли файл для обновления безопасности.
`linkShareMetadata.securityUpdateEnabled`	`boolean` Только вывод. Включено ли обновление безопасности для этого файла.
`labelInfo`	`object` Только вывод. Обзор меток в файле.
`labelInfo.labels[]`	`object ( Label )` Только вывод. Набор меток файла, запрошенный по идентификаторам меток в параметре `includeLabels` . По умолчанию метки не возвращаются.
`sha1Checksum`	`string` Только выходные данные. Контрольная сумма SHA1, связанная с этим файлом, если она доступна. Это поле заполняется только для файлов с содержимым, хранящимся на Google Диске; оно не заполняется для редакторов документов и файлов ярлыков.
`sha256Checksum`	`string` Только выходные данные. Контрольная сумма SHA256, связанная с этим файлом, если она доступна. Это поле заполняется только для файлов с содержимым, хранящимся на Google Диске; оно не заполняется для редакторов документов и файлов ярлыков.
`inheritedPermissionsDisabled`	`boolean` Отключены ли для этого файла унаследованные разрешения. По умолчанию унаследованные разрешения включены.

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

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

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`	Подписывается на изменения в файле.

REST Resource: files

Ресурс: Файл

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

Методы

`copy`

`delete`

`emptyTrash`

`export`

`generateIds`

`get`

`insert`

`list`

`listLabels`

`modifyLabels`

`patch`

`touch`

`trash`

`untrash`

`update`

`watch`

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

Ресурс: Файл

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

Методы

REST Resource: files