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-представление
{
  "nextPageToken": string,
  "kind": string,
  "permissions": [
    {
      object (Permission)
    }
  ]
}
Поля
nextPageToken

string

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

kind

string

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

permissions[]

object ( Permission )

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

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

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • 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

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