Ресурс: Диск
Представление общего диска.
Некоторые методы ресурсов (например, drives.update
) требуют идентификатор driveId
. Используйте метод drives.list
для получения идентификатора общего диска.
JSON-представление |
---|
{
"id": string,
"name": string,
"colorRgb": string,
"kind": string,
"backgroundImageLink": string,
"capabilities": {
"canAddChildren": boolean,
"canComment": boolean,
"canCopy": boolean,
"canDeleteDrive": boolean,
"canDownload": boolean,
"canEdit": boolean,
"canListChildren": boolean,
"canManageMembers": boolean,
"canReadRevisions": boolean,
"canRename": boolean,
"canRenameDrive": boolean,
"canChangeDriveBackground": boolean,
"canShare": boolean,
"canChangeCopyRequiresWriterPermissionRestriction": boolean,
"canChangeDomainUsersOnlyRestriction": boolean,
"canChangeDriveMembersOnlyRestriction": boolean,
"canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean,
"canResetDriveRestrictions": boolean,
"canDeleteChildren": boolean,
"canTrashChildren": boolean,
"canChangeDownloadRestriction": boolean
},
"themeId": string,
"backgroundImageFile": {
"id": string,
"xCoordinate": number,
"yCoordinate": number,
"width": number
},
"createdTime": string,
"hidden": boolean,
"restrictions": {
"copyRequiresWriterPermission": boolean,
"domainUsersOnly": boolean,
"driveMembersOnly": boolean,
"adminManagedRestrictions": boolean,
"sharingFoldersRequiresOrganizerPermission": boolean,
"downloadRestriction": {
object ( |
Поля | |
---|---|
id | Только вывод. Идентификатор этого общего диска, который также является идентификатором папки верхнего уровня этого общего диска. |
name | Имя этого общего диска. |
colorRgb | Цвет этого общего диска в виде шестнадцатеричной строки RGB. Его можно задать только в запросе |
kind | Только вывод. Определяет тип ресурса. Значение: фиксированная строка |
backgroundImageLink | Только вывод. Краткосрочная ссылка на фоновое изображение этого общего диска. |
capabilities | Только вывод. Возможности текущего пользователя на этом общем диске. |
capabilities.canAddChildren | Только вывод. Может ли текущий пользователь добавлять детей в папки на этом общем диске. |
capabilities.canComment | Только вывод. Может ли текущий пользователь комментировать файлы на этом общем диске. |
capabilities.canCopy | Только вывод. Может ли текущий пользователь копировать файлы на этом общем диске. |
capabilities.canDeleteDrive | Только вывод. Может ли текущий пользователь удалить этот общий диск. Попытка удалить общий диск может завершиться неудачей, если на нём есть неудалённые элементы. |
capabilities.canDownload | Только вывод. Может ли текущий пользователь загружать файлы с этого общего диска. |
capabilities.canEdit | Только вывод. Может ли текущий пользователь редактировать файлы на этом общем диске? |
capabilities.canListChildren | Только вывод. Может ли текущий пользователь выводить список дочерних папок на этом общем диске. |
capabilities.canManageMembers | Только вывод. Может ли текущий пользователь добавлять участников на этот общий диск, удалять их или изменять их роль. |
capabilities.canReadRevisions | Только вывод. Может ли текущий пользователь читать ресурсы версий файлов на этом общем диске. |
capabilities.canRename | Только вывод. Может ли текущий пользователь переименовывать файлы или папки на этом общем диске. |
capabilities.canRenameDrive | Только вывод. Может ли текущий пользователь переименовать этот общий диск. |
capabilities.canChangeDriveBackground | Только вывод. Может ли текущий пользователь изменить фон этого общего диска. |
capabilities.canShare | Только вывод. Может ли текущий пользователь предоставлять общий доступ к файлам или папкам на этом общем диске. |
capabilities.canChangeCopyRequiresWriterPermissionRestriction | Только вывод. Может ли текущий пользователь изменить ограничение |
capabilities.canChangeDomainUsersOnlyRestriction | Только вывод. Может ли текущий пользователь изменить ограничение |
capabilities.canChangeDriveMembersOnlyRestriction | Только вывод. Может ли текущий пользователь изменить ограничение |
capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction | Только вывод. Может ли текущий пользователь изменить ограничение |
capabilities.canResetDriveRestrictions | Только вывод. Может ли текущий пользователь сбросить ограничения общего диска до значений по умолчанию. |
capabilities.canDeleteChildren | Только вывод. Может ли текущий пользователь удалять дочерние элементы из папок на этом общем диске. |
capabilities.canTrashChildren | Только вывод. Может ли текущий пользователь удалять дочерние файлы из папок на этом общем диске. |
capabilities.canChangeDownloadRestriction | Только вывод. Может ли текущий пользователь изменять ограничения на загрузку, установленные организатором для этого общего диска? |
themeId | Идентификатор темы, из которой будут заданы фоновое изображение и цвет. Набор возможных |
backgroundImageFile | Файл изображения и параметры кадрирования, на основе которых задаётся фоновое изображение для этого общего диска. Это поле доступно только для записи; его можно задать только в запросах |
backgroundImageFile.id | Идентификатор файла изображения на Google Диске, который будет использоваться в качестве фонового изображения. |
backgroundImageFile.xCoordinate | Координата X верхнего левого угла области обрезки на фоновом изображении. Это значение находится в диапазоне от 0 до 1. Это значение представляет собой расстояние по горизонтали от левого края всего изображения до левого края области обрезки, делённое на ширину всего изображения. |
backgroundImageFile.yCoordinate | Координата Y верхнего левого угла области обрезки на фоновом изображении. Это значение находится в диапазоне от 0 до 1. Это значение представляет собой расстояние по вертикали от верхней стороны всего изображения до верхней стороны области обрезки, делённое на высоту всего изображения. |
backgroundImageFile.width | Ширина обрезанного изображения в закрытом диапазоне от 0 до 1. Это значение представляет собой ширину обрезанного изображения, деленную на ширину всего изображения. Высота рассчитывается путем применения соотношения сторон 80 к 9. Полученное изображение должно иметь ширину не менее 1280 пикселей и высоту не менее 144 пикселей. |
createdTime | Только вывод. Время создания общего диска (дата-время RFC 3339). |
restrictions | Набор ограничений, применяемых к этому общему диску или элементам на нём. Обратите внимание, что ограничения нельзя установить при создании общего диска. Чтобы добавить ограничение, сначала создайте общий диск, а затем используйте |
restrictions.copyRequiresWriterPermission | Нужно ли отключить для читателей и комментаторов возможность копирования, печати и загрузки файлов на этом общем диске? Если этому ограничению присвоено значение |
restrictions.domainUsersOnly | Ограничен ли доступ к этому общему диску и элементам на нём только пользователями домена, к которому принадлежит этот общий диск. Это ограничение может быть переопределено другими политиками общего доступа, управляемыми за пределами этого общего диска. |
restrictions.driveMembersOnly | Ограничен ли доступ к элементам на этом общем диске его участниками. |
restrictions.adminManagedRestrictions | Требуются ли права администратора на этом общем диске для изменения ограничений. |
restrictions.sharingFoldersRequiresOrganizerPermission | Если true, то предоставлять общий доступ к папкам могут только пользователи с ролью организатора. Если false, то предоставлять общий доступ к папкам могут пользователи либо с ролью организатора, либо с ролью организатора файлов. |
restrictions.downloadRestriction | Ограничения на загрузку, накладываемые менеджерами общих дисков. |
orgUnitId | Только вывод. Организационная единица этого общего диска. Это поле заполняется только в ответах |
Методы | |
---|---|
| Создает общий диск. |
| Безвозвратно удаляет общий диск, organizer которого является пользователь. |
| Получает метаданные общего диска по идентификатору. |
| Скрывает общий диск из представления по умолчанию. |
| Список общих дисков пользователя. |
| Восстанавливает вид общего диска по умолчанию. |
| Обновляет метаданные для общего диска. |