Ресурс: Разрешение
Разрешение для файла. Разрешение предоставляет пользователю, группе, домену или всему миру доступ к файлу или иерархии папок.
По умолчанию запросы разрешений возвращают только подмножество полей. Вид разрешения, идентификатор, тип и роль всегда возвращаются. Чтобы получить определенные поля, см. https://developers.google.com/drive/api/guides/fields-parameter.
Для некоторых методов ресурсов (например, permissions.update
) требуется permissionId
. Используйте метод permissions.list
, чтобы получить идентификатор файла, папки или общего диска.
JSON-представление |
---|
{ "id": string, "displayName": string, "type": string, "kind": string, "permissionDetails": [ { "permissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "photoLink": string, "emailAddress": string, "role": string, "allowFileDiscovery": boolean, "domain": string, "expirationTime": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean } |
Поля | |
---|---|
id | Только вывод. Идентификатор этого разрешения. Это уникальный идентификатор получателя гранта, который публикуется в ресурсах пользователя как |
displayName | Только вывод. «Красивое» имя значения разрешения. Ниже приведен список примеров для каждого типа разрешений:
|
type | Тип грантополучателя. Допустимые значения:
При создании разрешения, если |
kind | Только вывод. Определяет, что это за ресурс. Значение: фиксированная строка |
permissionDetails[] | Только вывод. Подробная информация о том, наследуются ли разрешения для этого объекта общего диска или непосредственно для этого объекта. Это поле предназначено только для вывода и присутствует только для элементов общего диска. |
permissionDetails[].permissionType | Только вывод. Тип разрешения для этого пользователя. Хотя в будущем могут быть добавлены новые значения, в настоящее время возможны следующие варианты:
|
permissionDetails[].inheritedFrom | Только вывод. Идентификатор элемента, от которого наследуется это разрешение. Это поле только для вывода. |
permissionDetails[].role | Только вывод. Основная роль для этого пользователя. Хотя в будущем могут быть добавлены новые значения, в настоящее время возможны следующие:
|
permissionDetails[].inherited | Только вывод. Наследуется ли это разрешение. Это поле всегда заполнено. Это поле только для вывода. |
photoLink | Только вывод. Ссылка на фотографию профиля пользователя, если таковая имеется. |
emailAddress | Адрес электронной почты пользователя или группы, к которым относится это разрешение. |
role | Роль, предоставленная этим разрешением. Хотя в будущем могут поддерживаться новые значения, в настоящее время разрешены следующие значения:
|
allowFileDiscovery | Позволяет ли разрешение обнаружить файл с помощью поиска. Это применимо только для разрешений типа |
domain | Домен, к которому относится это разрешение. |
expirationTime | Время истечения срока действия этого разрешения (дата-время RFC 3339). Срок годности имеет следующие ограничения:
|
teamDrivePermissionDetails[] | Только вывод. Устарело: только вывод. Вместо этого используйте |
teamDrivePermissionDetails[] | Устарело: только вывод. Вместо этого используйте |
teamDrivePermissionDetails[] | Устарело: только вывод. Вместо этого используйте |
teamDrivePermissionDetails[] | Устарело: только вывод. Вместо этого используйте |
teamDrivePermissionDetails[] | Устарело: только вывод. Вместо этого используйте |
deleted | Только вывод. Была ли удалена учетная запись, связанная с этим разрешением. Это поле относится только к разрешениям пользователей и групп. |
view | Указывает представление для этого разрешения. Заполняется только для разрешений, принадлежащих представлению. «опубликовано» — единственное поддерживаемое значение. |
pendingOwner | Является ли учетная запись, связанная с этим разрешением, ожидающим владельцем. Заполняется только для разрешений типа |
Методы | |
---|---|
| Создает разрешение для файла или общего диска. |
| Удаляет разрешение. |
| Получает разрешение по идентификатору. |
| Перечисляет разрешения файла или общего диска. |
| Обновляет разрешение с помощью семантики исправления. |