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

string

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

kind

string

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

etag

string

ETag списка.

items[]

object ( Permission )

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

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

Требуется одна из следующих областей 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

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