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

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

transferOwnership

boolean

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

useDomainAdminAccess

boolean

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

enforceExpansiveAccess

boolean

Должен ли запрос предусматривать расширенные правила доступа.

Текст запроса

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

Тело ответа

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

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

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

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

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