Method: permissions.insert

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

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

HTTP-запрос

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

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

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

Параметры
fileId

string

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

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

Параметры
emailMessage

string

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

enforceSingleParent
(deprecated)

boolean

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

moveToNewOwnersRoot

boolean

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

sendNotificationEmails

boolean

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

useDomainAdminAccess

boolean

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

enforceExpansiveAccess

boolean

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

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

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

Тело ответа

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

Области действия авторизации

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

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

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