Конференц-пространство представляет собой виртуальное место или постоянный объект (например, конференц-зал), где проводятся конференции. Конференц-пространство также помогает пользователям встречаться и находить общие ресурсы.
При создании пространства для совещаний с помощью метода 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 . Подробнее об участниках см. в разделе Управление участниками пространства .
Чтобы задать ограничения функций при модерации совещания ( on moderation ), задайте поле moderationRestrictions с помощью объекта ModerationRestrictions . Эти ограничения определяют, кто в пределах пространства совещания имеет разрешение отправлять сообщения чата и реакции, а также демонстрировать свой экран.
Чтобы задать ограничения функций для поля moderationRestrictions , используйте перечисление RestrictionType для применения chatRestriction , reactionRestriction , presentRestriction . Установите значение HOSTS_ONLY , чтобы разрешения применялись как к организатору встречи, так и к соорганизатору, или NO_RESTRICTION , чтобы они применялись ко всем участникам.
Чтобы ограничить роль, назначенную пользователям по умолчанию в качестве наблюдателей, задайте логическое поле defaultJoinAsViewerType с помощью перечисления DefaultJoinAsViewerType . Если defaultJoinAsViewerType равно on , пользователи присоединяются как читатели. Если off , пользователи присоединяются как участники. Значение по умолчанию — off . Если для пользователя явно задана роль в spaces.members , пользователь присоединяется с этой ролью.
Управление автоартефактами
Организаторы встреч, но не соорганизаторы, могут предварительно настроить автоматическую запись, автоматическое создание расшифровок и функцию «делать заметки для меня» в рамках конференции. При включении этих настроек запись конференции, создание расшифровок, а также автоматические сохранение и организация заметок в Google Docs. Каждая функция независима и настраивается для каждой конференции отдельно. Субтитры записи доступны только на английском языке.
Вы можете предварительно настроить автоматические артефакты либо при создании пространства для встреч , либо после его создания. Эта функция также позволяет настроить автоматические артефакты для встреч, созданных в 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 см. в разделе Знакомство с областями действия REST API .
Управление участниками пространства
Хотя организаторы встречи всегда могут войти в конференцию без стука, вы также можете настроить подключение других участников без стука. Кроме того, участникам можно назначить роль, например, COHOST , которая предоставит им те же возможности управления встречей, что и организатору. Подробнее о доступе к конференц-залу без стука см. в AccessType .
Ресурс spaces.members включает поля name , user и role .
Обратите внимание, что термин «участник» отличается от термина «участник» . Участник — это человек, присоединившийся к вызову, использующий режим Companion , наблюдающий за вызовом в качестве зрителя или подключенное к вызову устройство в конференц-зале. Для каждого участника существует один ресурс conferenceRecords.participants .
Управлять участниками пространства можно следующими способами:
Каждый метод принимает параметр пути, при этом методы create и list используют parent поле для обозначения места встречи, а методы delete и get используют поле name для фильтрации результатов на основе места встречи и имени участника.
Все методы, кроме delete, поддерживают параметр fields в SystemParameterContext . Если параметр fields не указан, ответ API по умолчанию будет "name,email,role,user" .
Параметр fields использует FieldMask для фильтрации ответов. FieldMask — это способ для вызывающих API перечислить поля, которые должен вернуть запрос. Это список полей, разделенный запятыми, позволяющий указать, что используются только определенные поля объекта, а остальные поля остаются без изменений. Использование FieldMask позволяет API избежать ненужной работы и повышает производительность. Маска поля используется для методов create, get и list. Подробнее о масках полей см. в статье Использование масок полей API Google Таблиц.