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
(deprecated)

boolean

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

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

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

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

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

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

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

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

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