Предложение о доступе – это предложение от запрашивающего к утверждающему лицу предоставить получателю доступ к элементу Google Диска.
Утверждающий может просмотреть и принять меры по всем нерешенным предложениям о доступе к файлам на Диске. Это означает, что вы можете ускорить процесс утверждения, программно запросив предложения о доступе и затем разрешив их. Это также позволяет утверждающему лицу просматривать предложения в совокупности.
API Google Диска предоставляет ресурс accessproposals
, позволяющий просматривать и разрешать ожидающие предложения доступа. Методы ресурса accessproposals
работают с файлами, папками и файлами на общем диске, но не на общем диске.
Следующие условия являются специфическими для предложений доступа:
- Запрашивающая сторона : пользователь, инициирующий предложение доступа к элементу Диска.
- Получатель : пользователь, получающий дополнительные разрешения для файла, если предложение доступа предоставлено. Во многих случаях получатель совпадает с запрашивающим, но не всегда.
- Утверждающий : пользователь, ответственный за утверждение (или отклонение) предложения о доступе. Обычно это происходит потому, что они являются владельцами документа или имеют возможность поделиться им.
Список ожидающих рассмотрения предложений о доступе
Чтобы просмотреть все ожидающие предложения доступа к элементу Диска, вызовите метод list()
ресурса accessproposals
и включите параметр пути fileId
.
Только утверждающие в файле могут перечислять ожидающие рассмотрения предложения в файле. Утверждающий — это пользователь с возможностью can_approve_access_proposals
для файла. Если запрашивающая сторона не является утверждающим, возвращается пустой список. Дополнительные сведения о capabilities
см. в разделе Общие сведения о возможностях файлов .
Тело ответа состоит из объекта AccessProposal
, представляющего список неразрешенных предложений доступа к файлу.
Объект AccessProposal
включает информацию о каждом предложении, такую как запрашивающая сторона, получатель и сообщение, добавленное запрашивающей стороной. Он также включает объект AccessProposalRoleAndView
, который группирует предлагаемую role
запрашивающей стороны с view
. Поскольку role
— это повторяющееся поле, для каждого предложения может существовать несколько значений. Например, предложение может иметь объект AccessProposalRoleAndView
с значениями role=reader
и view=published
, а также дополнительный объект AccessProposalRoleAndView
только со значением role=writer
. Дополнительную информацию см. в разделе Представления .
Передайте следующие параметры запроса, чтобы настроить нумерацию страниц или отфильтровать предложения доступа:
pageToken
: токен страницы, полученный в результате предыдущего вызова списка. Предоставьте этот токен для получения следующей страницы.pageSize
: максимальное количество предложений доступа, возвращаемых на страницу.
Решите ожидающие предложения о доступе
Чтобы разрешить все ожидающие предложения доступа к элементу Диска, вызовите resolve()
ресурса accessproposals
и включите параметры пути fileId
и proposalId
.
resolve()
включает параметр запроса action
, который обозначает действие, которое необходимо выполнить над предложением. Объект Action
отслеживает изменение состояния предложения, поэтому мы знаем, принимается оно или отклоняется.
resolve()
также включает необязательные параметры запроса role
и view
. Поддерживаются только роли writer
, commenter
и reader
. Если роль не указана, по умолчанию используется reader
. Дополнительный необязательный параметр запроса send_notification
позволяет отправлять уведомление по электронной почте запрашивающей стороне, когда предложение принимается или отклоняется.
Как и в случае с методом list()
, пользователи, разрешающие предложение, должны иметь возможность can_approve_access_proposals
для файла. Дополнительные сведения о capabilities
см. в разделе Общие сведения о возможностях файлов .
Предложения рассматриваются с использованием тех же шаблонов, которые указаны в разделе «Сценарии совместного использования ресурсов Диска» . Если для одного и того же пользователя имеется несколько предложений, но с разными ролями, применяется следующее:
- Если одно предложение принято, а другое отклонено, принятая роль применяется к элементу на Диске.
- Если оба предложения принимаются одновременно, применяется предложение с более высоким разрешением (например,
role=writer
илиrole=reader
). Другое предложение доступа удаляется из элемента.
После отправки предложения в методsolve resolve()
действие совместного использования завершается. AccessProposal
больше не возвращается через метод list()
. После принятия предложения пользователь должен использовать коллекцию permissions
для обновления разрешений для файла или папки. Дополнительные сведения см. в разделе Разрешения на обновление .
Связанные темы
,Предложение о доступе – это предложение от запрашивающего к утверждающему лицу предоставить получателю доступ к элементу Google Диска.
Утверждающий может просмотреть и принять меры по всем нерешенным предложениям о доступе к файлам на Диске. Это означает, что вы можете ускорить процесс утверждения, программно запросив предложения о доступе и затем разрешив их. Это также позволяет утверждающему лицу просматривать предложения в совокупности.
API Google Диска предоставляет ресурс accessproposals
, позволяющий просматривать и разрешать ожидающие предложения доступа. Методы ресурса accessproposals
работают с файлами, папками и файлами на общем диске, но не на общем диске.
Следующие условия являются специфическими для предложений доступа:
- Запрашивающая сторона : пользователь, инициирующий предложение доступа к элементу Диска.
- Получатель : пользователь, получающий дополнительные разрешения для файла, если предложение доступа предоставлено. Во многих случаях получатель совпадает с запрашивающим, но не всегда.
- Утверждающий : пользователь, ответственный за утверждение (или отклонение) предложения о доступе. Обычно это происходит потому, что они являются владельцами документа или имеют возможность поделиться им.
Список ожидающих рассмотрения предложений о доступе
Чтобы просмотреть все ожидающие предложения доступа к элементу Диска, вызовите метод list()
ресурса accessproposals
и включите параметр пути fileId
.
Только утверждающие в файле могут перечислять ожидающие рассмотрения предложения в файле. Утверждающий — это пользователь с возможностью can_approve_access_proposals
для файла. Если запрашивающая сторона не является утверждающим, возвращается пустой список. Дополнительные сведения о capabilities
см. в разделе Общие сведения о возможностях файлов .
Тело ответа состоит из объекта AccessProposal
, представляющего список неразрешенных предложений доступа к файлу.
Объект AccessProposal
включает информацию о каждом предложении, такую как запрашивающая сторона, получатель и сообщение, добавленное запрашивающей стороной. Он также включает объект AccessProposalRoleAndView
, который группирует предлагаемую role
запрашивающей стороны с view
. Поскольку role
— это повторяющееся поле, для каждого предложения может существовать несколько значений. Например, предложение может иметь объект AccessProposalRoleAndView
с значениями role=reader
и view=published
, а также дополнительный объект AccessProposalRoleAndView
только со значением role=writer
. Дополнительную информацию см. в разделе Представления .
Передайте следующие параметры запроса, чтобы настроить нумерацию страниц или отфильтровать предложения доступа:
pageToken
: токен страницы, полученный в результате предыдущего вызова списка. Предоставьте этот токен для получения следующей страницы.pageSize
: максимальное количество предложений доступа, возвращаемых на страницу.
Решите ожидающие предложения о доступе
Чтобы разрешить все ожидающие предложения доступа к элементу Диска, вызовите resolve()
ресурса accessproposals
и включите параметры пути fileId
и proposalId
.
resolve()
включает параметр запроса action
, который обозначает действие, которое необходимо выполнить над предложением. Объект Action
отслеживает изменение состояния предложения, поэтому мы знаем, принимается оно или отклоняется.
resolve()
также включает необязательные параметры запроса role
и view
. Поддерживаются только роли writer
, commenter
и reader
. Если роль не указана, по умолчанию используется reader
. Дополнительный необязательный параметр запроса send_notification
позволяет отправлять уведомление по электронной почте запрашивающей стороне, когда предложение принимается или отклоняется.
Как и в случае с методом list()
, пользователи, разрешающие предложение, должны иметь возможность can_approve_access_proposals
для файла. Дополнительные сведения о capabilities
см. в разделе Общие сведения о возможностях файлов .
Предложения рассматриваются с использованием тех же шаблонов, которые указаны в разделе «Сценарии совместного использования ресурсов Диска» . Если для одного и того же пользователя имеется несколько предложений, но с разными ролями, применяется следующее:
- Если одно предложение принято, а другое отклонено, принятая роль применяется к элементу на Диске.
- Если оба предложения принимаются одновременно, применяется предложение с более высоким разрешением (например,
role=writer
илиrole=reader
). Другое предложение доступа удаляется из элемента.
После отправки предложения в методsolve resolve()
действие совместного использования завершается. AccessProposal
больше не возвращается через метод list()
. После принятия предложения пользователь должен использовать коллекцию permissions
для обновления разрешений для файла или папки. Дополнительные сведения см. в разделе Разрешения на обновление .