REST Resource: spaces

資源：Space

會議的虛擬場地。在任何時間點，一個空間只能進行一場會議。

JSON 表示法 
{
  "name": string,
  "meetingUri": string,
  "meetingCode": string,
  "config": {
    object (SpaceConfig)
  },
  "activeConference": {
    object (ActiveConference)
  }
}
欄位
name

string

不可變動。聊天室的資源名稱。

格式：spaces/{space}。

{space} 是空間的資源 ID。這是由伺服器產生的不重複 ID，且區分大小寫。例如 jQCFfuBOdN5z。

詳情請參閱「Meet 如何識別會議空間」。
meetingUri

string

僅供輸出。用於加入會議的 URI，由 https://meet.google.com/ 和 meetingCode 組成。例如：https://meet.google.com/abc-mnop-xyz。
meetingCode

string

僅供輸出。用於加入會議的友善型專屬字串。

格式：[a-z]+-[a-z]+-[a-z]+。例如 abc-mnop-xyz。

長度上限為 128 個半形字元。

只能用來取得聊天室，做為聊天室名稱的別名。
config

object (SpaceConfig)

與會議空間相關的設定。
activeConference

object (ActiveConference)

進行中的會議 (如果有的話)。

SpaceConfig

與會議空間相關的設定。

JSON 表示法 
{
  "accessType": enum (AccessType),
  "entryPointAccess": enum (EntryPointAccess),
  "moderation": enum (Moderation),
  "moderationRestrictions": {
    object (ModerationRestrictions)
  },
  "attendanceReportGenerationType": enum (AttendanceReportGenerationType),
  "artifactConfig": {
    object (ArtifactConfig)
  }
}
欄位
accessType

enum (AccessType)

會議聊天室的存取類型，用於決定哪些使用者不必提出要求就能加入會議。預設：使用者的預設存取權設定。企業版使用者由使用者管理員控管，或設為「RESTRICTED」。
entryPointAccess

enum (EntryPointAccess)

定義可用於加入在這個會議空間中主持的會議的進入點。預設值：EntryPointAccess.ALL
moderation

enum (Moderation)

會議的預先設定管理模式。預設值：由使用者政策控制。
moderationRestrictions

object (ModerationRestrictions)

當 moderation.ON 為開啟時，這些限制就會套用至會議。如果 moderation.OFF，則會重設為預設的 ModerationRestrictions。
attendanceReportGenerationType

enum (AttendanceReportGenerationType)

會議空間是否已啟用出席狀況報告。
artifactConfig

object (ArtifactConfig)

與會議支援的自動產生構件相關的設定。

AccessType

會議空間的可能存取權類型。

列舉
ACCESS_TYPE_UNSPECIFIED 使用者機構指定的預設值。注意：系統一律會傳回設定的存取類型，因此不會傳回這個值。
OPEN 凡是取得加入資訊 (例如網址或電話存取資訊) 的使用者，都可以不必提出要求就加入會議。
TRUSTED 主辦人機構的成員、受邀的外部使用者，以及撥入的使用者，都可以不必提出加入要求就加入會議。其他人則必須提出要求。
RESTRICTED 只有受邀者可以直接加入會議，不必先傳送加入要求。其他人則必須提出要求。

EntryPointAccess

可用來加入會議的入口點。範例：meet.google.com、Meet 嵌入 SDK Web 或行動應用程式。

列舉
ENTRY_POINT_ACCESS_UNSPECIFIED 未使用。
ALL 允許所有進入點。
CREATOR_APP_ONLY 只有建立空間的 Google Cloud 專案擁有的入口點，才能用於加入該空間中的會議。應用程式可以使用 Meet 嵌入 SDK Web 或行動版 Meet SDK 建立自有進入點。

管理

會議的管理模式。啟用管理模式後，會議擁有者就能進一步控管會議，例如管理共同主辦人 (請參閱訊息「Member」) 和功能限制 (請參閱訊息「ModerationRestrictions」)。

列舉
MODERATION_UNSPECIFIED 未指定管理類型。這項值用於指出使用者不打算更新狀態，因此未指定任何值。使用者不得將值設為未指定。
OFF 管理功能已關閉。
ON 已啟用審核功能。

ModerationRestrictions

定義會議經過審核後的功能限制。

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)

定義是否要將預設角色限制為使用者檢視者。

RestrictionType

判斷哪些使用者有權使用特定功能。

列舉
RESTRICTION_TYPE_UNSPECIFIED 使用者政策指定的預設值。這項值一律不應傳回。
HOSTS_ONLY 會議擁有者和共同主辦人具有此權限。
NO_RESTRICTION 所有參與者皆有權限。

DefaultJoinAsViewerType

根據預設，使用者會以協作者身分加入。主辦人可以限制使用者以觀眾身分加入。注意：如果在 Member 資源中為使用者設定明確的角色，使用者就會以該角色加入。

列舉
DEFAULT_JOIN_AS_VIEWER_TYPE_UNSPECIFIED 使用者政策指定的預設值。這項值一律不應傳回。
ON 使用者預設會以觀眾身分加入。
OFF 根據預設，使用者會以貢獻者身分加入。

AttendanceReportGenerationType

會議空間是否啟用出席狀況報告的可能狀態。

列舉
ATTENDANCE_REPORT_GENERATION_TYPE_UNSPECIFIED 使用者政策指定的預設值。這項值一律不應傳回。
GENERATE_REPORT 系統會產生出席狀況報告，並傳送至 Google 雲端硬碟/電子郵件。
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} 是空間中每個呼叫例項的專屬 ID。

方法

create

 建立聊天室。

endActiveConference

 結束正在進行的會議 (如果有)。

get

 取得會議空間的詳細資料。

patch

 更新會議空間的詳細資料。