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, то запрашивающей стороне будет предоставлен доступ, если параметр идентификатора файла относится к общему диску, а запрашивающая сторона является администратором домена, к которому принадлежит общий диск.

Тело запроса

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

Тело ответа

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

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

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

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

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