Method: permissions.insert

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

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

HTTP-запрос

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

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

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

Параметры
fileId

string

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

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

Параметры
emailMessage

string

Текстовое сообщение, которое можно добавить в электронные письма с уведомлениями.

enforceSingleParent
(deprecated)

boolean

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

moveToNewOwnersRoot

boolean

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

sendNotificationEmails

boolean

Указывается, следует ли отправлять уведомления по электронной почте при предоставлении доступа пользователям или группам. Этот параметр игнорируется, и электронное письмо отправляется, если role — owner .

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

useDomainAdminAccess

boolean

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

enforceExpansiveAccess
(deprecated)

boolean

Устарело: все запросы используют расширенные правила доступа.

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

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

Ответный текст

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

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

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

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