Method: permissions.list

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

HTTP-запрос

GET https://www.googleapis.com/drive/v3/files/{fileId}/permissions

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

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

Параметры
fileId

string

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

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

Параметры
pageSize

integer

Максимальное количество разрешений, возвращаемых на страницу. Если не задано для файлов на общем диске, будет возвращено не более 100 результатов. Если не задано для файлов, не находящихся на общем диске, будет возвращен весь список.

pageToken

string

Токен для продолжения предыдущего запроса списка на следующей странице. Значение должно быть равно значению «nextPageToken» из предыдущего ответа.

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

useDomainAdminAccess

boolean

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

includePermissionsForView

string

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

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

Тело запроса должно быть пустым.

Тело ответа

Список разрешений для файла.

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
Поля
permissions[]

object ( Permission )

Список разрешений. Если nextPageToken заполнен, этот список может быть неполным, и необходимо загрузить дополнительную страницу результатов.

nextPageToken

string

Токен страницы для следующей страницы разрешений. Это поле будет отсутствовать, если достигнут конец списка разрешений. Если токен по какой-либо причине отклонён, его следует удалить, а пагинацию следует перезапустить с первой страницы результатов. Токен страницы обычно действителен в течение нескольких часов. Однако при добавлении или удалении новых элементов ожидаемые результаты могут отличаться.

kind

string

Определяет тип ресурса. Значение: фиксированная строка "drive#permissionList" .

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

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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