Пространство для собраний представляет собой виртуальное место или постоянный объект (например, комнату для собраний), где проводятся конференции. Пространство для встреч также помогает пользователям встречаться и находить общие ресурсы.
Когда вы создаете пространство для собраний с помощью метода spaces.create , он возвращает экземпляр ресурса spaces . Ресурс включает объект SpaceConfig , который представляет собой конфигурацию помещения для собраний. Он также содержит объект ActiveConference , который является ссылкой на текущий ресурс conferenceRecords в пространстве собрания. Дополнительные сведения об управлении пространством для собраний см. в разделе Создание пространств для собраний и управление ими .
В следующих разделах подробно описано, как настроить пространство для собраний с помощью этих объектов и методов.
Установите модерацию и доступ к собранию
С помощью объекта SpaceConfig вы можете указать, как пользователи присоединяются к собранию, режимы модерации, ограничения функций и разрешения, которые пользователи получают при присоединении к собранию.
Доступ к помещениям для встреч
Чтобы определить, кто может присоединиться к месту встречи без стука, установите поле accessType с помощью объекта AccessType . Вы можете выбрать один из нескольких параметров, разрешать ли участникам автоматически присоединяться. По умолчанию в этом поле указаны настройки доступа пользователя по умолчанию.
Чтобы определить точки входа, которые можно использовать для присоединения к собраниям, проводимым в пространстве для собраний, задайте поле entryPointAccess с помощью объекта EntryPointAccess . Установите значение ALL , чтобы разрешить все точки входа, или CREATOR_APP_ONLY чтобы ограничить точки входа только теми, которые принадлежат проекту Google Cloud, который создал пространство для собраний.
Создать отчет о посещаемости
Чтобы создать отчет о посещаемости для конференц-зала, задайте логическое поле attendanceReportGenerationType с помощью объекта AttendanceReportGenerationType . Если запрашивается отчет, Google Meet сохраняет отчет о посещаемости на Google Диске организатора собрания, а также отправляет электронное письмо.
Умеренные помещения для встреч
Чтобы модерировать собрание, вы можете установить логическое поле moderation с помощью объекта Moderation . Когда режим moderation on , организатор собрания может контролировать собрание с помощью таких функций, как управление соорганизаторами (см. spaces.members ) и ограничения функций с помощью поля moderationRestrictions . Дополнительную информацию об участниках см. в разделе Управление участниками пространства .
Чтобы определить ограничения функций, когда собрание модерируется ( moderation on ), установите поле moderationRestrictions с помощью объекта ModerationRestrictions . Ограничения определяют, кто имеет разрешение в пространстве собрания отправлять сообщения или реакции чата или делиться своим экраном.
Чтобы установить ограничения функции в поле moderationRestrictions , используйте перечисление RestrictionType , чтобы применить chatRestriction , reactionRestriction , presentRestriction . Установите значение HOSTS_ONLY , чтобы применить разрешения как к организатору собрания, так и к соорганизатору, или NO_RESTRICTION , чтобы применить разрешения ко всем участникам.
Чтобы ограничить роль по умолчанию, назначенную пользователям в качестве средства просмотра, установите логическое поле defaultJoinAsViewerType с помощью перечисления DefaultJoinAsViewerType . Если defaultJoinAsViewerType on , пользователи присоединяются в качестве зрителей. Если off , пользователи присоединяются в качестве участников. По умолчанию off . Если для пользователя задана явная роль в spaces.members , пользователь присоединяется в качестве этой роли.
Управление автоматическими артефактами
Организаторы собрания, но не соорганизаторы, могут предварительно настроить автоматическую запись, авторасшифровку и «делать заметки для меня» в помещении собрания. Когда эти настройки включены, пространство собрания записывается, генерируются стенограммы, а заметки собрания автоматически сохраняются и систематизируются в Документах Google. Каждая функция независима и настраивается для каждого конференц-зала. Субтитры к записи доступны только на английском языке.
Вы можете предварительно настроить автоматические артефакты либо при создании пространства для собраний , либо после его создания. Эта функция также позволяет настраивать автоматические артефакты для встреч, созданных из Календаря Google. Для обоих методов требуется область OAuth meetings.space.settings . Дополнительную информацию см. в разделе Области действия OAuth для настроек .
Чтобы установить автоматические артефакты, используйте объект ArtifactConfig в объекте SpaceConfig . ArtifactConfig состоит из полей recordingConfig , transcriptionConfig и smartNotesConfig .
Каждое поле сопоставляется с аналогичным объектом, например RecordingConfig , TranscriptionConfig и SmartNotesConfig . Чтобы установить каждый объект, используйте логическое перечисление AutoGenerationType для on или off объекта конфигурации.
Области OAuth для настроек
Для настройки или доступа к настройкам собраний требуются следующие области OAuth:
| Вариант использования | Код области действия |
|---|---|
| Установите автоматическое создание артефактов для пространств, созданных другими приложениями. | https://www.googleapis.com/auth/meetings.space.settings |
| Получайте или перечисляйте артефакты из конференций, созданных другими приложениями. | https://www.googleapis.com/auth/meetings.space.readonly |
| Получите или перечислите другие настройки места для собраний перед собранием, созданного сторонним приложением. | https://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| Прочитайте и отредактируйте настройки всех пространств для собраний, к которым пользователь может получить доступ через любое другое приложение, например Календарь. | https://www.googleapis.com/auth/meetings.space.settings |
Дополнительную информацию об областях OAuth см. в разделе «Области API REST» .
Управление участниками пространства
Организаторы собрания всегда могут войти на собрание без стука, но вы также можете настроить дополнительных участников на присоединение к собранию без стука. Кроме того, участникам можно настроить роль в собрании, например COHOST , что дает им те же возможности по управлению собранием, что и организатору собрания. Дополнительные сведения о доступе к месту встречи без стука см. в AccessType .
Ресурс spaces.members включает поля name , user и role .
Обратите внимание, что участник отличается от участника . Участник — это человек, присоединившийся к вызову или использующий режим Companion , наблюдающий за происходящим в качестве зрителя, или устройство в комнате, подключенное к вызову. Для каждого человека имеется один ресурс conferenceRecords.participants .
Управлять участниками пространства можно следующими способами:
Каждый метод принимает параметр пути, методы create и list используют parent поле для обозначения пространства собрания, а методы delete и get используют поле name для фильтрации результатов на основе пространства собрания и имени участника.
Все методы, кроме удаления, поддерживают параметр fields в SystemParameterContext . Если параметр fields опущен, ответ API по умолчанию имеет значение "name,email,role,user" .
Параметр fields использует FieldMask для фильтрации ответов. FieldMask — это способ для вызывающих API перечислить поля, которые должен вернуть запрос. Это список полей, разделенных запятыми, позволяющий указать, что в объекте используются только определенные поля, а остальные поля остаются неизменными. Использование FieldMask позволяет API избежать ненужной работы и повышает производительность. Маска поля используется для методов создания, получения и списка. Дополнительную информацию о масках полей см. в статье Использование масок полей Google Sheets API.