REST Resource: drives

Ресурс: Диск

Представление общего диска.

Некоторые методы ресурсов (например, 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 (DownloadRestriction)
    }
  },
  "orgUnitId": string
}
Поля
id

string

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

name

string

Имя этого общего диска.

colorRgb

string

Цвет этого общего диска в виде шестнадцатеричной строки RGB. Его можно задать только в запросе drive.drives.update , который не устанавливает themeId .

kind

string

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

capabilities

object

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

capabilities.canAddChildren

boolean

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

capabilities.canComment

boolean

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

capabilities.canCopy

boolean

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

capabilities.canDeleteDrive

boolean

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

capabilities.canDownload

boolean

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

capabilities.canEdit

boolean

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

capabilities.canListChildren

boolean

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

capabilities.canManageMembers

boolean

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

capabilities.canReadRevisions

boolean

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

capabilities.canRename

boolean

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

capabilities.canRenameDrive

boolean

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

capabilities.canChangeDriveBackground

boolean

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

capabilities.canShare

boolean

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

capabilities.canChangeCopyRequiresWriterPermissionRestriction

boolean

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

capabilities.canChangeDomainUsersOnlyRestriction

boolean

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

capabilities.canChangeDriveMembersOnlyRestriction

boolean

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

capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

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

capabilities.canResetDriveRestrictions

boolean

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

capabilities.canDeleteChildren

boolean

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

capabilities.canTrashChildren

boolean

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

capabilities.canChangeDownloadRestriction

boolean

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

themeId

string

Идентификатор темы, из которой будут заданы фоновое изображение и цвет. Набор возможных driveThemes можно получить из ответа drive.about.get . Если тема не указана в запросе drive.drives.create , она выбирается случайным образом, из которой задаются фоновое изображение и цвет. Это поле доступно только для записи; его можно задать только в запросах, не задающих colorRgb или backgroundImageFile .

backgroundImageFile

object

Файл изображения и параметры кадрирования, на основе которых задаётся фоновое изображение для этого общего диска. Это поле доступно только для записи; его можно задать только в запросах drive.drives.update , не устанавливающих themeId . При указании этого поля должны быть заданы все поля backgroundImageFile .

backgroundImageFile.id

string

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

backgroundImageFile.xCoordinate

number

Координата X верхнего левого угла области обрезки на фоновом изображении. Это значение находится в диапазоне от 0 до 1. Это значение представляет собой расстояние по горизонтали от левого края всего изображения до левого края области обрезки, делённое на ширину всего изображения.

backgroundImageFile.yCoordinate

number

Координата Y верхнего левого угла области обрезки на фоновом изображении. Это значение находится в диапазоне от 0 до 1. Это значение представляет собой расстояние по вертикали от верхней стороны всего изображения до верхней стороны области обрезки, делённое на высоту всего изображения.

backgroundImageFile.width

number

Ширина обрезанного изображения в закрытом диапазоне от 0 до 1. Это значение представляет собой ширину обрезанного изображения, деленную на ширину всего изображения. Высота рассчитывается путем применения соотношения сторон 80 к 9. Полученное изображение должно иметь ширину не менее 1280 пикселей и высоту не менее 144 пикселей.

createdTime

string

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

hidden

boolean

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

restrictions

object

Набор ограничений, применяемых к этому общему диску или элементам на нём. Обратите внимание, что ограничения нельзя установить при создании общего диска. Чтобы добавить ограничение, сначала создайте общий диск, а затем используйте drives.update для добавления ограничений.

restrictions.copyRequiresWriterPermission

boolean

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

restrictions.domainUsersOnly

boolean

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

restrictions.driveMembersOnly

boolean

Ограничен ли доступ к элементам на этом общем диске его участниками.

restrictions.adminManagedRestrictions

boolean

Требуются ли права администратора на этом общем диске для изменения ограничений.

restrictions.sharingFoldersRequiresOrganizerPermission

boolean

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

restrictions.downloadRestriction

object ( DownloadRestriction )

Ограничения на загрузку, накладываемые менеджерами общих дисков.

orgUnitId

string

Только вывод. Организационная единица этого общего диска. Это поле заполняется только в ответах drives.list , если параметр useDomainAdminAccess имеет значение true .

Методы

create

Создает общий диск.

delete

Безвозвратно удаляет общий диск, organizer которого является пользователь.

get

Получает метаданные общего диска по идентификатору.

hide

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

list

Список общих дисков пользователя.

unhide

Восстанавливает вид общего диска по умолчанию.

update

Обновляет метаданные для общего диска.