Method: files.accessproposals.list

Перечислите AccessProposals в файле. Примечание. Только утверждающие могут перечислять AccessProposals в файле. Если пользователь не является утверждающим, возвращается ошибка 403.

HTTP-запрос

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

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

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

Параметры
file Id

string

Необходимый. Идентификатор элемента, к которому относится запрос.

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

Параметры
page Token

string

Необязательный. Токен продолжения в списке запросов доступа.

page Size

integer

Необязательный. Количество результатов на странице

Тело запроса

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

Тело ответа

Ответ на запрос списка предложений доступа.

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

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

object ( AccessProposal )

Список предложений доступа. Это поле заполняется только в версиях v3 и v3beta.

next Page Token

string

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

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

Требуется одна из следующих областей 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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

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

ДоступПредложение

Ресурс «Предложение доступа» для невыполненных предложений доступа к файлу.

JSON-представление 
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
Поля
file Id

string

Идентификатор файла, к которому предлагается доступ.

proposal Id

string

Идентификатор предложения доступа

requester Email Address

string

Адрес электронной почты запрашивающего пользователя

recipient Email Address

string

Адрес электронной почты пользователя, который получит разрешения в случае принятия.

roles And Views[]

object ( RoleAndView )

Обертка для роли и представления предложения доступа.

request Message

string

Сообщение, которое отправитель запроса добавил в предложение.

create Time

string ( Timestamp format)

Время создания

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

РольИВью

Обертка для роли и представления предложения доступа.

JSON-представление 
{
  "role": string,
  "view": string
}
Поля
role

string

Роль, предложенная запрашивающим. В будущем могут быть добавлены новые значения, но в настоящее время возможны следующие: * writer * commenter * reader

view

string

Указывает представление для этого предложения доступа. Заполняется только для предложений, принадлежащих представлению. published — единственное поддерживаемое значение.