Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Общие диски используют другие модели организации, совместного доступа и владения, чем «Мой диск». Поэтому некоторые операции «Моего диска» не разрешены для контента на общем диске.
В этом руководстве описываются различия в files и ресурсах API, характерные для общих дисков, и changes ресурсы.
Файловый ресурс
Следующие поля в ресурсе files заполняются только для файлов, расположенных на общем диске:
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 : это поле имеет значение true только для корневой папки «Мой диск»; для папки верхнего уровня общего диска оно имеет значение false.
parents : родительский элемент не отображается в списке родителей, если запрашивающий пользователь не является участником общего диска и не имеет к нему доступа. Кроме того, за исключением папки верхнего уровня, родительский элемент должен содержать ровно один элемент, если файл находится на общем диске.
capabilities/canRemoveChildren : Используйте capabilities/canDeleteChildren или capabilities/canTrashChildren .
Изменить ресурс
В ресурсе changes для общего диска доступны следующие новые поля:
changeType : Тип изменения. Возможные значения: file и drive .
driveId : идентификатор общего диска, связанного с этим изменением.
drive : обновленное состояние общего диска. Присутствует, если changeType — drive , а пользователь всё ещё является участником общего диска.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-08-29 UTC."],[],[],null,["# Shared drive versus My Drive API differences\n\nShared drives follow different organization, sharing, and ownership models from\na My Drive. As such, some My Drive operations\naren't permitted for content in a shared drive.\n\nThis guide outlines shared drive-specific API differences in the `files` and\n`changes` resources.\n\nFile resource\n-------------\n\nThe following fields in the [`files`](/workspace/drive/api/reference/rest/v3/files) resource are\nonly populated for files located within a shared drive:\n\n- `hasAugmentedPermissions`: Whether any users are granted file access directly on this file.\n- `capabilities/canAddFolderFromAnotherDrive`: Whether the current user can add a folder from another drive (a different shared drive or My Drive) to this folder.\n- `capabilities/canDeleteChildren`: Whether the current user can delete children of this folder.\n- `capabilities/canMoveChildrenOutOfDrive`: Whether the current user can move children of this folder outside of the shared drive.\n- `capabilities/canMoveChildrenWithinDrive`: Whether the current user can move children of this folder within the shared drive.\n- `capabilities/canMoveItemWithinDrive`: Whether the current user can move this shared drive item within the shared drive.\n- `capabilities/canReadDrive`: Whether the current user has read access to the shared drive to which this file belongs.\n- `capabilities/canTrashChildren`: Whether the current user can trash children of this folder.\n- `driveId`: The ID of the shared drive where the file is located.\n- `trashingUser`: If the file has been explicitly trashed, the user who trashed it.\n- `trashedTime`: The time that the item was trashed. If you're using the older Drive API v2, this field is called `trashedDate`.\n\nThe following fields aren't populated for files located within a shared drive:\n\n- `permissions`: Due to the potential size of shared drive access control lists (ACLs), permissions aren't returned as part of files. Use the `permissions.list` method, which supports pagination, to list permissions for a file within a shared drive or the shared drive folder.\n- `owners`, `ownerNames`, `ownedByMe`: Files within a shared drive are owned by the shared drive, not individual users.\n- `folderColorRgb`: Folders cannot be colored individually.\n- `shared`: All items in a shared drive are shared.\n- `writersCanShare`: It's not possible to restrict sharing by role in shared drives.\n\nThe following fields are only set when the user has been granted file access\npermissions on an item:\n\n- `sharedWithMeDate`\n- `sharingUser`\n\nThe following fields require special consideration when you use them with shared\ndrives:\n\n- `parents.isRoot`: This field is only true for the My Drive root folder; it's false for the shared drive top-level folder.\n- `parents`: A parent doesn't appear in the parents list if the requesting\n user isn't a member of the shared drive and doesn't have access to the\n parent. In addition, with the exception of the top level folder, the parents\n list must contain exactly one item if the file is located within a shared\n drive.\n\n | **Note:** If you're using the older Drive API v2:\n | - `shareable`: Deprecated. Use `capabilities/canShare`.\n | - `editable`: Deprecated. Use `capabilities/canEdit`.\n | - `copyable`: Deprecated. Use `capabilities/canCopy`.\n | - `canComment`: Deprecated. Use `capabilities/canComment`.\n | - `canReadRevisions`: Deprecated. Use `capabilities/canReadRevisions`.\n- `capabilities/canRemoveChildren`: Use `capabilities/canDeleteChildren` or\n `capabilities/canTrashChildren`.\n\nChange resource\n---------------\n\nThe following new fields are available in the\n[`changes`](/workspace/drive/api/reference/rest/v3/changes) resource for a shared drive:\n\n- `changeType`: The change type. Possible values are `file` and `drive`.\n- `driveId`: The ID of the shared drive associated with this change.\n- `drive`: The updated state of the shared drive. Present if the `changeType` is `drive` and the user is still a member of the shared drive.\n\nAdditional changes might be required for applications that need to sync content\nwith shared drives or track activity. For details, see [Track changes for users\nand shared drives](/workspace/drive/api/guides/about-changes).\n\nRelated topics\n--------------\n\n- [Files and folders overview](/workspace/drive/api/guides/about-files)\n- [Changes and revisions overview](/workspace/drive/api/guides/change-overview)"]]