Управление ожидающими предложениями доступа,Управление ожидающими предложениями доступа

Предложение о доступе – это предложение от запрашивающего к утверждающему лицу предоставить получателю доступ к элементу 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 для обновления разрешений для файла или папки. Дополнительные сведения см. в разделе Разрешения на обновление .