REST Resource: spaces

Ресурс: Космос

Виртуальная площадка для проведения конференций. В одном месте одновременно может проводиться только одна активная конференция.

JSON-представление 
{
  "name": string,
  "meetingUri": string,
  "meetingCode": string,
  "config": {
    object (SpaceConfig)
  },
  "activeConference": {
    object (ActiveConference)
  },
  "phoneAccess": [
    {
      object (PhoneAccess)
    }
  ],
  "gatewaySipAccess": [
    {
      object (GatewaySipAccess)
    }
  ]
}
Поля
name

string

Неизменяемый. Имя ресурса пространства.

Формат: spaces/{space} .

{space} — это идентификатор ресурса для пространства. Это уникальный идентификатор, сгенерированный сервером, и он чувствителен к регистру. Например, jQCFfuBOdN5z .

Для получения более подробной информации см. раздел «Как Meet определяет место для проведения встречи» .

meetingUri

string

Только для вывода. URI, используемый для присоединения к встречам, состоит из https://meet.google.com/ , за которым следует meetingCode . Например, https://meet.google.com/abc-mnop-xyz .

meetingCode

string

Только вывод. Уникальная строка, удобная для ввода, используемая для присоединения к встрече.

Формат: [az]+-[az]+-[az]+ . Например, abc-mnop-xyz .

Максимальная длина составляет 128 символов.

Может использоваться только в качестве псевдонима для имени пространства, чтобы получить доступ к этому пространству.

config

object ( SpaceConfig )

Конфигурация переговорной комнаты.

activeConference

object ( ActiveConference )

Действующая конференция, если таковая имеется.

phoneAccess[]

object ( PhoneAccess )

Только вывод. Доступ к этому конференц-залу возможен по всем региональным телефонным номерам. Может быть пустым.

gatewaySipAccess[]

object ( GatewaySipAccess )

Только вывод. Методы доступа на основе SIP, которые можно использовать для присоединения к конференции. Может быть пустым.

SpaceConfig

Конфигурация помещения для проведения встреч.

JSON-представление 
{
  "accessType": enum (AccessType),
  "entryPointAccess": enum (EntryPointAccess),
  "moderation": enum (Moderation),
  "moderationRestrictions": {
    object (ModerationRestrictions)
  },
  "attendanceReportGenerationType": enum (AttendanceReportGenerationType),
  "artifactConfig": {
    object (ArtifactConfig)
  }
}
Поля
accessType

enum ( AccessType )

Тип доступа к конференц-залу, определяющий, кто может присоединиться без стука в дверь. По умолчанию: настройки доступа пользователя по умолчанию. Для корпоративных пользователей управляется администратором или имеет значение «Ограниченный».

entryPointAccess

enum ( EntryPointAccess )

Определяет точки входа, которые можно использовать для присоединения к совещаниям, проводимым в этом конференц-зале. По умолчанию: EntryPointAccess.ALL

moderation

enum ( Moderation )

Предварительно настроенный режим модерации для собрания. По умолчанию: определяется политиками пользователя.

moderationRestrictions

object ( ModerationRestrictions )

При включении параметра moderation.ON эти ограничения вступают в силу для всего собрания. При выключении параметра moderation.OFF они сбрасываются до значений по умолчанию.

attendanceReportGenerationType

enum ( AttendanceReportGenerationType )

Включена ли функция отслеживания посещаемости для конференц-зала.

artifactConfig

object ( ArtifactConfig )

Настройки, относящиеся к автоматически генерируемым артефактам, которые поддерживает встреча.

Тип доступа

Возможные типы доступа в конференц-зал.

Перечисления
ACCESS_TYPE_UNSPECIFIED Значение по умолчанию задается организацией пользователя. Примечание: это значение никогда не возвращается, поскольку вместо него возвращается настроенный тип доступа.
OPEN Любой, у кого есть информация для подключения (например, URL-адрес или данные для доступа по телефону), может подключиться без стука в дверь.
TRUSTED Члены организации организатора, приглашенные внешние пользователи и пользователи, подключающиеся по телефону, могут присоединиться без стука. Всем остальным необходимо стучать.
RESTRICTED Вступить в клуб без стука могут только приглашенные. Все остальные должны стучать.

EntryPointAccess

Точки входа, которые можно использовать для присоединения к встрече. Например: meet.google.com , Meet Embed SDK Web или мобильное приложение.

Перечисления
ENTRY_POINT_ACCESS_UNSPECIFIED Неиспользованный.
ALL Доступ разрешен через все пункты пропуска.
CREATOR_APP_ONLY Для участия в совещаниях в этом пространстве можно использовать только точки входа, принадлежащие проекту Google Cloud, создавшему это пространство. Приложения могут использовать Meet Embed SDK Web или мобильные SDK Meet для создания собственных точек входа.

Модерация

Режим модерации для собрания. Когда режим модерации включен, организатор собрания получает больший контроль над ним благодаря таким функциям, как управление соорганизатором (см. сообщение «Участник») и ограничения на использование функций (см. сообщение «Ограничения модерации»).

Перечисления
MODERATION_UNSPECIFIED Тип модерации не указан. Это означает, что пользователь не указал никакого значения, поскольку не намерен обновлять состояние. Пользователям не разрешается устанавливать значение «не указано».
OFF Модерация отключена.
ON Модерация включена.

Ограничения модерации

Определяет ограничения для функций при модерации собрания.

JSON-представление 
{
  "chatRestriction": enum (RestrictionType),
  "reactionRestriction": enum (RestrictionType),
  "presentRestriction": enum (RestrictionType),
  "defaultJoinAsViewerType": enum (DefaultJoinAsViewerType)
}
Поля
chatRestriction

enum ( RestrictionType )

Определяет, кто имеет право отправлять сообщения в чате в пространстве для совещаний.

reactionRestriction

enum ( RestrictionType )

Определяет, кто имеет право отправлять реакции в пространстве для совещаний.

presentRestriction

enum ( RestrictionType )

Определяет, кто имеет право демонстрировать свой экран в конференц-зале.

defaultJoinAsViewerType

enum ( DefaultJoinAsViewerType )

Определяет, следует ли ограничивать роль, назначаемую пользователям по умолчанию, ролью «просмотрщик».

Тип ограничения

Определяет, кто имеет право использовать ту или иную функцию.

Перечисления
RESTRICTION_TYPE_UNSPECIFIED Значение по умолчанию, заданное политикой пользователя. Оно никогда не должно возвращаться.
HOSTS_ONLY Владелец встречи и соорганизатор имеют на это разрешение.
NO_RESTRICTION Все участники имеют соответствующие разрешения.

DefaultJoinAsViewerType

По умолчанию пользователи будут присоединяться в качестве участников. Организаторы могут ограничить возможность присоединения пользователей только в качестве зрителей. Примечание: если для пользователя в ресурсе "Участник" задана явная роль, пользователь будет присоединяться в этой роли.

Перечисления
DEFAULT_JOIN_AS_VIEWER_TYPE_UNSPECIFIED Значение по умолчанию, заданное политикой пользователя. Оно никогда не должно возвращаться.
ON По умолчанию пользователи будут присоединяться в качестве зрителей.
OFF По умолчанию пользователи будут присоединяться в качестве участников.

AttendanceReportGenerationType

Возможные состояния, в которых включена функция отслеживания посещаемости для конференц-зала.

Перечисления
ATTENDANCE_REPORT_GENERATION_TYPE_UNSPECIFIED Значение по умолчанию, заданное политикой пользователя. Оно никогда не должно возвращаться.
GENERATE_REPORT Будет сформирован отчет о посещаемости, который будет отправлен на диск/электронную почту.
DO_NOT_GENERATE Отчет о посещаемости формироваться не будет.

ArtifactConfig

Настройки, относящиеся к материалам совещания, которые могут быть созданы в этом конференц-зале.

JSON-представление 
{
  "recordingConfig": {
    object (RecordingConfig)
  },
  "transcriptionConfig": {
    object (TranscriptionConfig)
  },
  "smartNotesConfig": {
    object (SmartNotesConfig)
  }
}
Поля
recordingConfig

object ( RecordingConfig )

Настройки для записи.

transcriptionConfig

object ( TranscriptionConfig )

Настройка автоматической расшифровки.

smartNotesConfig

object ( SmartNotesConfig )

Настройки для автоматического создания интеллектуальных заметок.

RecordingConfig

Настройки, связанные с записью в конференц-зале.

JSON-представление 
{
  "autoRecordingGeneration": enum (AutoGenerationType)
}
Поля
autoRecordingGeneration

enum ( AutoGenerationType )

Определяет, будет ли место проведения совещания автоматически записываться, когда к совещанию присоединяется пользователь, имеющий право записи.

AutoGenerationType

Определяет, может ли артефакт быть автоматически сгенерирован в месте проведения совещания.

Перечисления
AUTO_GENERATION_TYPE_UNSPECIFIED Значение по умолчанию, заданное политикой пользователя. Оно никогда не должно возвращаться.
ON Артефакт генерируется автоматически.
OFF Артефакт не генерируется автоматически.

TranscriptionConfig

Настройки, связанные с транскрипцией в конференц-зале.

JSON-представление 
{
  "autoTranscriptionGeneration": enum (AutoGenerationType)
}
Поля
autoTranscriptionGeneration

enum ( AutoGenerationType )

Определяет, будет ли содержание совещания автоматически записываться при присоединении к нему лица, имеющего право на запись.

SmartNotesConfig

Настройки, связанные с интеллектуальными заметками в конференц-зале. Для получения дополнительной информации об интеллектуальных заметках см. раздел «Создание заметок для меня» в Google Meet .

JSON-представление 
{
  "autoSmartNotesGeneration": enum (AutoGenerationType)
}
Поля
autoSmartNotesGeneration

enum ( AutoGenerationType )

Определяет, следует ли автоматически генерировать краткое изложение и сводку совещания для всех приглашенных в организации, когда к совещанию присоединяется пользователь с правами на включение интеллектуальных заметок.

ActiveConference

Активная конференция.

JSON-представление 
{
  "conferenceRecord": string
}
Поля
conferenceRecord

string

Только вывод. Ссылка на ресурс 'ConferenceRecord'. Формат: conferenceRecords/{conferenceRecord} , ​​где {conferenceRecord} — уникальный идентификатор для каждого вызова в рамках пространства.

Телефонный доступ

Информация для доступа к телефонной линии включает данные, необходимые для подключения к конференции по региональному номеру телефона и PIN-коду, специфичному для этого номера.

JSON-представление 
{
  "phoneNumber": string,
  "pin": string,
  "regionCode": string,
  "languageCode": string
}
Поля
phoneNumber

string

Номер телефона для связи с этим конференц-залом в формате E.164. Полный номер телефона с символом '+' в начале.

pin

string

PIN-код, который пользователи должны ввести после набора указанного номера. PIN-код состоит только из десятичных цифр и может варьироваться.

regionCode

string

Региональный код CLDR/ISO 3166 для страны, связанной с этим телефонным доступом. Для обработки утилитой i18n RegionCode. Пример: "SE" для Швеции.

languageCode

string

Языковой код BCP 47/LDML для языка, связанного с этим телефонным доступом. Для обработки утилитой i18n LanguageCode. Примеры: "es-419" для латиноамериканского испанского, "fr-CA" для канадского французского.

GatewaySipAccess

Подробности о том, как присоединиться к конференции через SIP-шлюз.

JSON-представление 
{
  "uri": string,
  "sipAccessCode": string
}
Поля
uri

string

URI протокола инициации сессии (SIP), по которому можно подключиться к конференции.

Строка имеет один из следующих форматов:

где USER_ID — это 13-значный универсальный PIN-код (с возможностью в будущем использовать также код встречи Meet), а GATEWAY_ADDRESS — это допустимый адрес, который должен быть определен с помощью DNS SRV-запроса или точечного квадра.

sipAccessCode

string

Постоянный числовой код для ручного ввода на специально настроенных устройствах.

Методы

create

 Создаёт пространство.

endActiveConference

 Завершает текущую конференцию (если таковая имеется).

get

 Получает подробную информацию о месте проведения встречи.

patch

 Обновляет информацию о месте проведения встречи.