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

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

Ресурс Files

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

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

  • trashedTime — время, когда элемент был удален.

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

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

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

  • sharedWithMeDate
  • sharingUser

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

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

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

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

Ресурс Permissions

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

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

Changes ресурс

В ресурсе Changes общего диска доступны следующие новые поля:

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

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

,

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

Ресурс Files

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

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

  • trashedTime — время, когда элемент был удален.

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

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

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

  • sharedWithMeDate
  • sharingUser

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

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

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

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

Ресурс Permissions

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

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

Changes ресурс

В ресурсе Changes общего диска доступны следующие новые поля:

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

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