Пространство для собраний представляет собой виртуальное место или постоянный объект (например, комнату для собраний), где проводятся конференции. Пространство для встреч также помогает пользователям встречаться и находить общие ресурсы.
Когда вы создаете пространство для собраний с помощью метода 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.