Method: permissions.list

Отображает права доступа к файлу или общему диску. Дополнительную информацию см. в разделе «Общий доступ к файлам, папкам и дискам» .

HTTP-запрос

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

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

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

Параметры
fileId

string

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

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

Параметры
pageSize

integer

Максимальное количество возвращаемых разрешений. Сервис может вернуть меньшее количество разрешений.

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

Максимальное значение — 100; значения выше 100 будут принудительно уменьшены до 100.

pageToken

string

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

useDomainAdminAccess

boolean

Отправьте запрос от имени администратора домена.

Если установлено значение true и выполняются следующие дополнительные условия, запрашивающему предоставляется доступ:

  1. Параметр идентификатора файла указывает на общий диск.
  2. Заявителем является администратор домена, к которому принадлежит общий диск.

Для получения дополнительной информации см. раздел «Управление общими дисками от имени администраторов домена» .

includePermissionsForView

string

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

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

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

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

Список прав доступа к файлу.

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

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

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