Пространство для собраний представляет собой виртуальное место или постоянный объект (например, комнату для собраний), где проводятся конференции. Пространство для встреч также помогает пользователям встречаться и находить общие ресурсы.
Когда вы создаете пространство для встреч с помощью метода spaces.create() , он возвращает экземпляр ресурса spaces . Ресурс включает объект SpaceConfig , который представляет собой конфигурацию помещения для собраний. Он также содержит объект ActiveConference , который является ссылкой на текущий ресурс conferenceRecords в пространстве собрания. Дополнительные сведения об управлении пространством для собраний см. в разделе Работа с пространствами для собраний .
В следующих разделах подробно описано, как настроить пространство для собраний с помощью нескольких новых бета-объектов и методов.
Установите модерацию и доступ к собранию
С помощью новых бета-объектов теперь вы можете устанавливать режимы модерации, ограничения функций и разрешения, которые пользователи получают при присоединении к собранию. Они устанавливаются через обновленный объект SpaceConfig .
Поле moderation представляет собой предварительно настроенный режим модерации для собрания, режим по умолчанию контролируется политиками пользователя. Он использует объект Moderation . Когда режим модерации включен, организатор собрания может контролировать собрание с помощью таких функций, как управление соорганизаторами (см. spaces.members ) и ограничения функций (см. moderationRestrictions ). Дополнительную информацию об участниках см. в разделе Управление участниками пространства .
Поле moderationRestrictions устанавливает ограничения модерации для собрания, когда moderation включена. Он использует объект ModerationRestrictions . Ограничения определяют, кто имеет разрешение отправлять сообщения и реакции чата, делиться своим экраном, а также следует ли ограничивать роль по умолчанию, назначенную пользователям в качестве зрителя. Поле moderationRestrictions использует RestrictionType для применения первых трех ограничений. RestrictionType можно применить к организатору и соорганизатору собрания или ко всем участникам. DefaultJoinAsViewerType применяет окончательное разрешение, при котором пользователи присоединяются в качестве участников по умолчанию, но где хосты также могут запретить пользователям присоединяться в качестве зрителей.
Поле firstJoinerType определяет, могут ли пользователи присоединяться к конференциям в этом конференц-зале раньше организатора. Он определяет, какие пользователи могут присоединиться к собранию первыми, а другие находятся в состоянии ожидания. Он использует объект FirstJoinerType .
Управление участниками пространства
Организатор собрания всегда мог войти на собрание без стука, но теперь вы можете настроить участников, которые также могут присоединиться к собранию без стука. Кроме того, участникам можно настроить роль в собрании, например 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.
Управление автоматическими артефактами
Организаторы собрания, но не соорганизаторы, могут предварительно настроить автоматическую запись, авторасшифровку и «делать заметки для меня» в помещении собрания. Когда эти настройки включены, автоматически записывается место встречи, создаются стенограммы, а заметки встречи автоматически сохраняются и систематизируются в Документах Google. Каждая функция независима и настраивается для каждого конференц-зала. Субтитры к записи доступны только на английском языке.
Вы можете предварительно настроить автоматические артефакты либо при создании пространства для собраний , либо после его создания. Эта функция также позволяет настраивать автоматические артефакты для встреч, созданных из Календаря Google. Для обоих методов требуется область OAuth meetings.space.settings . Дополнительную информацию см. в разделе Области действия OAuth для настроек .
Автоматические артефакты задаются с помощью объекта ArtifactConfig в объекте SpaceConfig , который является частью ресурса spaces . ArtifactConfig состоит из полей recordingConfig , transcriptionConfig и smartNotesConfig .
Каждое поле сопоставляется с аналогичным объектом, например RecordingConfig , TranscriptionConfig и SmartNotesConfig . Каждый объект задается с помощью логического перечисления AutoGenerationType для включения или выключения объекта конфигурации.
Области 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 см. в разделе «Области взаимодействия с REST API» .