Method: permissions.create

Создает разрешение для файла или общего диска.

Предупреждение. Одновременные операции с разрешениями для одного и того же файла не поддерживаются; применяется только последнее обновление.

HTTP-запрос

POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
fileId

string

Идентификатор файла или общего диска.

Параметры запроса

Параметры
emailMessage

string

Простое текстовое сообщение, которое будет включено в электронное письмо с уведомлением.

enforceSingleParent
(deprecated)

boolean

Устарело: подробности см. в moveToNewOwnersRoot .

moveToNewOwnersRoot

boolean

Этот параметр вступит в силу только в том случае, если объект не находится на общем диске и запрос пытается передать право собственности на объект. Если установлено значение true , элемент будет перемещен в корневую папку «Мой диск» нового владельца, а все предыдущие родительские элементы будут удалены. Если установлено значение false , родители не изменяются.

sendNotificationEmail

boolean

Отправлять ли уведомление по электронной почте при совместном использовании пользователям или группам. По умолчанию это значение истинно для пользователей и групп и не разрешено для других запросов. Его нельзя отключать для передачи прав собственности.

supportsAllDrives

boolean

Поддерживает ли запрашивающее приложение как «Мои диски», так и общие диски.

supportsTeamDrives
(deprecated)

boolean

Устарело: вместо этого используйте supportsAllDrives .

transferOwnership

boolean

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

useDomainAdminAccess

boolean

Оформите запрос от имени администратора домена; если установлено значение true, то запрашивающей стороне будет предоставлен доступ, если параметр идентификатора файла относится к общему диску, а запрашивающая сторона является администратором домена, к которому принадлежит общий диск.

Тело запроса

Тело запроса содержит экземпляр Permission .

Тело ответа

В случае успеха тело ответа содержит вновь созданный экземпляр Permission .

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

Некоторые области ограничены, и для их использования требуется оценка безопасности вашего приложения. Дополнительную информацию см. в руководстве по авторизации .