Method: permissions.list

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

HTTP-запрос

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

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

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

Параметры
fileId

string

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

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

Параметры
maxResults

integer

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

pageToken

string

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

useDomainAdminAccess

boolean

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

includePermissionsForView

string

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

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

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

Тело ответа

Список разрешений, связанных с файлом.

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

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

object ( Permission )

Список разрешений.

nextPageToken

string

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

kind

string

Это всегда drive#permissionList .

etag

string

ETag списка.

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

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

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

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