Разница между общим диском и API «Моего диска»

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

Файловый ресурс

Следующие поля в ресурсе File заполняются только для файлов, расположенных на общем диске:

  • hasAugmentedPermissions : предоставляется ли каким-либо пользователям доступ непосредственно к этому файлу.
  • capabilities/canAddFolderFromAnotherDrive : может ли текущий пользователь добавить папку с другого диска (другого общего диска или «Мой диск») в эту папку.
  • capabilities/canDeleteChildren : может ли текущий пользователь удалять дочерние элементы этой папки.
  • capabilities/canMoveChildrenOutOfDrive : может ли текущий пользователь перемещать дочерние элементы этой папки за пределы общего диска.
  • capabilities/canMoveChildrenWithinDrive : может ли текущий пользователь перемещать дочерние элементы этой папки на общем диске.
  • capabilities/canMoveItemWithinDrive : может ли текущий пользователь перемещать этот элемент общего диска на общем диске.
  • capabilities/canReadDrive : имеет ли текущий пользователь доступ для чтения к общему диску, которому принадлежит этот файл.
  • capabilities/canTrashChildren : может ли текущий пользователь удалять дочерние элементы этой папки.
  • driveId : идентификатор общего диска, на котором находится файл.
  • trashingUser : если файл был явно удален, указывается пользователь, который его удалил.
  • trashedTime : время, когда элемент был удален. Если вы используете более старую версию Drive API v2, это поле trashedDate .

Следующие поля не заполняются для файлов, расположенных на общем диске:

  • permissions : из-за потенциального размера списков ACL общего диска разрешения не возвращаются как часть файлов. Используйте метод permissions.list() , который поддерживает нумерацию страниц, чтобы получить список разрешений для файла на общем диске или в папке общего диска.
  • owners , ownerNames , ownedByMe : файлы на общем диске принадлежат общему диску, а не отдельным пользователям.
  • folderColorRgb : папки не могут быть окрашены индивидуально.
  • shared : все объекты на общем диске являются общими.
  • writersCanShare : невозможно ограничить общий доступ по роли на общих дисках.

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

  • sharedWithMeDate
  • sharingUser

Следующие поля требуют особого внимания при использовании их с общими дисками:

  • parents.isRoot : это поле истинно только для корневой папки «Мой диск»; это неверно для папки верхнего уровня общего диска.

  • parents : Родитель не отображается в списке родителей, если запрашивающий пользователь не является участником общего диска и не имеет доступа к родителю. Кроме того, за исключением папки верхнего уровня, список родителей должен содержать ровно один элемент, если файл находится на общем диске.

  • capabilities/canRemoveChildren : используйте capabilities/canDeleteChildren или capabilities/canTrashChildren .

Ресурс разрешения

Поле permissionDetails в ресурсе Permission заполняется только для файлов, расположенных на общем диске. Это поле представляет собой список сокращенных разрешений, которые принадлежат этому файлу на общем диске или унаследованы им. Это поле предназначено только для вывода и присутствует только для элементов общего диска. Кроме того,

  • Были определены две новые роли organizer и fileOrganizer .
  • Метод permissions.list() поддерживает нумерацию страниц.

Изменить ресурс

В ресурсе Change общий диск» доступны следующие новые поля:

  • changeType : тип изменения. Возможные значения: file и drive .
  • driveId : идентификатор общего диска, связанного с этим изменением.
  • drive : обновленное состояние общего диска. Присутствует, если в changeType указан drive , а пользователь по-прежнему является участником общего диска.

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