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 и выполнены следующие дополнительные условия, запрашивающей стороне предоставляется доступ:

  1. Параметр идентификатора файла относится к общему диску.
  2. Запрашивающая сторона является администратором домена, к которому принадлежит общий диск.

Дополнительные сведения см. в разделе Управление общими дисками в качестве администраторов домена .

enforceExpansiveAccess

boolean

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

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

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

Тело ответа

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

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

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

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

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