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