REST Resource: spaces

Tài nguyên: Không gian

Địa điểm ảo nơi tổ chức hội nghị. Mỗi lần, bạn chỉ có thể tổ chức một hội nghị truyền hình đang hoạt động trong một không gian.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "meetingUri": string,
  "meetingCode": string,
  "config": {
    object (SpaceConfig)
  },
  "activeConference": {
    object (ActiveConference)
  },
  "phoneAccess": [
    {
      object (PhoneAccess)
    }
  ],
  "gatewaySipAccess": [
    {
      object (GatewaySipAccess)
    }
  ]
}
Trường
name

string

Không thể thay đổi. Tên tài nguyên của không gian.

Định dạng: spaces/{space}.

{space} là giá trị nhận dạng tài nguyên cho khoảng trống. Đây là một mã nhận dạng duy nhất do máy chủ tạo và có phân biệt chữ hoa chữ thường. Ví dụ: jQCFfuBOdN5z.

Để biết thêm thông tin, hãy xem bài viết Cách Meet xác định không gian họp.

meetingUri

string

Chỉ có đầu ra. URI dùng để tham gia cuộc họp, bao gồm https://meet.google.com/, theo sau là meetingCode. Ví dụ: https://meet.google.com/abc-mnop-xyz.

meetingCode

string

Chỉ có đầu ra. Nhập chuỗi duy nhất thân thiện dùng để tham gia cuộc họp.

Định dạng: [a-z]+-[a-z]+-[a-z]+. Ví dụ: abc-mnop-xyz.

Độ dài tối đa là 128 ký tự.

Chỉ có thể dùng làm bí danh của tên không gian để lấy không gian.

config

object (SpaceConfig)

Cấu hình liên quan đến không gian trong cuộc họp.

activeConference

object (ActiveConference)

Hội nghị đang diễn ra (nếu có).

phoneAccess[]

object (PhoneAccess)

Chỉ có đầu ra. Tất cả các phương thức truy cập qua điện thoại theo khu vực cho không gian họp này. Có thể để trống.

gatewaySipAccess[]

object (GatewaySipAccess)

Chỉ có đầu ra. Các phương thức truy cập dựa trên SIP có thể dùng để tham gia hội nghị. Có thể để trống.

SpaceConfig

Cấu hình liên quan đến không gian trong cuộc họp.

Biểu diễn dưới dạng JSON
{
  "accessType": enum (AccessType),
  "entryPointAccess": enum (EntryPointAccess),
  "moderation": enum (Moderation),
  "moderationRestrictions": {
    object (ModerationRestrictions)
  },
  "attendanceReportGenerationType": enum (AttendanceReportGenerationType),
  "artifactConfig": {
    object (ArtifactConfig)
  }
}
Trường
accessType

enum (AccessType)

Loại quyền truy cập của không gian họp, quyết định những người có thể tham gia mà không cần gửi yêu cầu. Mặc định: Chế độ cài đặt quyền truy cập mặc định của người dùng. Do quản trị viên của người dùng kiểm soát đối với người dùng doanh nghiệp hoặc BỊ HẠN CHẾ.

entryPointAccess

enum (EntryPointAccess)

Xác định các điểm truy cập có thể dùng để tham gia cuộc họp được tổ chức trong không gian họp này. Mặc định: EntryPointAccess.ALL

moderation

enum (Moderation)

Chế độ kiểm duyệt được định cấu hình sẵn cho Cuộc họp. Mặc định: Do chính sách của người dùng kiểm soát.

moderationRestrictions

object (ModerationRestrictions)

Khi chế độ kiểm duyệt ở trạng thái BẬT, những hạn chế này sẽ có hiệu lực đối với cuộc họp. Khi moderation.OFF, sẽ được đặt lại thành ModerationRestrictions mặc định.

attendanceReportGenerationType

enum (AttendanceReportGenerationType)

Bảng điểm danh có được bật cho không gian tổ chức hội nghị hay không.

artifactConfig

object (ArtifactConfig)

Cấu hình liên quan đến các thành phần được tạo tự động mà cuộc họp hỗ trợ.

AccessType

Các loại quyền truy cập có thể có đối với không gian tổ chức cuộc họp.

Enum
ACCESS_TYPE_UNSPECIFIED Giá trị mặc định do tổ chức của người dùng chỉ định. Lưu ý: Giá trị này không bao giờ được trả về, vì thay vào đó, loại quyền truy cập đã định cấu hình sẽ được trả về.
OPEN Bất kỳ ai có thông tin tham gia (ví dụ: URL hoặc thông tin truy cập qua điện thoại) đều có thể tham gia mà không cần yêu cầu.
TRUSTED Các thành viên trong tổ chức của người tổ chức, người dùng bên ngoài được mời và người dùng gọi điện có thể tham gia mà không cần yêu cầu tham gia. Những người khác phải yêu cầu tham gia.
RESTRICTED Chỉ những người được mời mới có thể tham gia mà không cần yêu cầu. Những người khác phải yêu cầu tham gia.

EntryPointAccess

Các điểm truy cập có thể dùng để tham gia cuộc họp. Ví dụ: meet.google.com, Meet Embed SDK Web hoặc một ứng dụng di động.

Enum
ENTRY_POINT_ACCESS_UNSPECIFIED Không dùng đến.
ALL Bạn được phép sử dụng tất cả các điểm truy cập.
CREATOR_APP_ONLY Bạn chỉ có thể dùng những điểm truy cập thuộc dự án trên đám mây của Google đã tạo không gian này để tham gia cuộc họp trong không gian. Các ứng dụng có thể sử dụng Meet Embed SDK Web hoặc SDK Meet dành cho thiết bị di động để tạo các điểm truy cập thuộc sở hữu của ứng dụng.

Kiểm duyệt

Chế độ điều phối cho cuộc họp. Khi chế độ kiểm duyệt được bật, chủ sở hữu cuộc họp sẽ có nhiều quyền kiểm soát hơn đối với cuộc họp thông qua các tính năng như quản lý người đồng tổ chức (xem thông báo Thành viên) và hạn chế tính năng (xem thông báo ModerationRestrictions).

Enum
MODERATION_UNSPECIFIED Bạn chưa chỉ định loại kiểm duyệt. Điều này được dùng để cho biết người dùng chưa chỉ định giá trị nào vì không có ý định cập nhật trạng thái. Người dùng không được phép đặt giá trị là không xác định.
OFF Chế độ kiểm duyệt đang tắt.
ON Chế độ kiểm duyệt đang bật.

ModerationRestrictions

Xác định các quy định hạn chế đối với các tính năng khi cuộc họp được kiểm duyệt.

Biểu diễn dưới dạng JSON
{
  "chatRestriction": enum (RestrictionType),
  "reactionRestriction": enum (RestrictionType),
  "presentRestriction": enum (RestrictionType),
  "defaultJoinAsViewerType": enum (DefaultJoinAsViewerType)
}
Trường
chatRestriction

enum (RestrictionType)

Xác định những người có quyền gửi tin nhắn trò chuyện trong không gian họp.

reactionRestriction

enum (RestrictionType)

Xác định những người có quyền gửi lượt thể hiện cảm xúc trong không gian họp.

presentRestriction

enum (RestrictionType)

Xác định những người có quyền chia sẻ màn hình trong không gian họp.

defaultJoinAsViewerType

enum (DefaultJoinAsViewerType)

Xác định xem có hạn chế vai trò mặc định được chỉ định cho người dùng là người xem hay không.

RestrictionType

Xác định những người có quyền sử dụng một tính năng cụ thể.

Enum
RESTRICTION_TYPE_UNSPECIFIED Giá trị mặc định do chính sách người dùng chỉ định. Không bao giờ được trả về giá trị này.
HOSTS_ONLY Chủ sở hữu cuộc họp và người đồng tổ chức có quyền này.
NO_RESTRICTION Tất cả người tham gia đều có quyền.

DefaultJoinAsViewerType

Theo mặc định, người dùng sẽ tham gia với tư cách là người đóng góp. Người tổ chức có thể hạn chế người dùng tham gia với tư cách là người xem. Lưu ý: Nếu bạn đặt một vai trò rõ ràng cho người dùng trong tài nguyên Thành viên, thì người dùng sẽ tham gia với vai trò đó.

Enum
DEFAULT_JOIN_AS_VIEWER_TYPE_UNSPECIFIED Giá trị mặc định do chính sách người dùng chỉ định. Không bao giờ được trả về giá trị này.
ON Theo mặc định, người dùng sẽ tham gia với tư cách là người xem.
OFF Theo mặc định, người dùng sẽ tham gia với tư cách là người đóng góp.

AttendanceReportGenerationType

Các trạng thái có thể có của việc bật bảng điểm danh cho không gian tổ chức cuộc họp.

Enum
ATTENDANCE_REPORT_GENERATION_TYPE_UNSPECIFIED Giá trị mặc định do chính sách người dùng chỉ định. Không bao giờ được trả về giá trị này.
GENERATE_REPORT Bảng điểm danh sẽ được tạo và gửi đến Drive/email.
DO_NOT_GENERATE Bảng điểm danh sẽ không được tạo.

ArtifactConfig

Cấu hình liên quan đến các nội dung cuộc họp có thể được tạo bởi không gian họp này.

Biểu diễn dưới dạng JSON
{
  "recordingConfig": {
    object (RecordingConfig)
  },
  "transcriptionConfig": {
    object (TranscriptionConfig)
  },
  "smartNotesConfig": {
    object (SmartNotesConfig)
  }
}
Trường
recordingConfig

object (RecordingConfig)

Cấu hình để ghi.

transcriptionConfig

object (TranscriptionConfig)

Cấu hình cho tính năng tự động chép lời.

smartNotesConfig

object (SmartNotesConfig)

Cấu hình cho tính năng ghi chú thông minh tự động.

RecordingConfig

Cấu hình liên quan đến việc ghi lại trong không gian họp.

Biểu diễn dưới dạng JSON
{
  "autoRecordingGeneration": enum (AutoGenerationType)
}
Trường
autoRecordingGeneration

enum (AutoGenerationType)

Xác định xem một không gian họp có được ghi lại tự động hay không khi có người có đặc quyền ghi lại tham gia cuộc họp.

AutoGenerationType

Xác định xem một cấu phần phần mềm có thể được tạo tự động trong không gian họp hay không.

Enum
AUTO_GENERATION_TYPE_UNSPECIFIED Giá trị mặc định do chính sách người dùng chỉ định. Không bao giờ được trả về giá trị này.
ON Cấu phần phần mềm được tạo tự động.
OFF Hiện vật không được tạo tự động.

TranscriptionConfig

Cấu hình liên quan đến tính năng chép lời trong không gian cuộc họp.

Biểu diễn dưới dạng JSON
{
  "autoTranscriptionGeneration": enum (AutoGenerationType)
}
Trường
autoTranscriptionGeneration

enum (AutoGenerationType)

Xác định xem nội dung của cuộc họp có được chép lời tự động hay không khi có người có đặc quyền chép lời tham gia cuộc họp.

SmartNotesConfig

Cấu hình liên quan đến ghi chú thông minh trong không gian trong cuộc họp. Để biết thêm thông tin về ghi chú thông minh, hãy xem bài viết Tính năng"Ghi chú cho tôi" trong Google Meet.

Biểu diễn dưới dạng JSON
{
  "autoSmartNotesGeneration": enum (AutoGenerationType)
}
Trường
autoSmartNotesGeneration

enum (AutoGenerationType)

Xác định xem có tự động tạo bản tóm tắt và bản tổng kết cuộc họp cho tất cả người được mời trong tổ chức hay không khi có người có đặc quyền bật ghi chú thông minh tham gia cuộc họp.

ActiveConference

Hội nghị truyền hình đang diễn ra.

Biểu diễn dưới dạng JSON
{
  "conferenceRecord": string
}
Trường
conferenceRecord

string

Chỉ có đầu ra. Tham chiếu đến tài nguyên "ConferenceRecord". Định dạng: conferenceRecords/{conferenceRecord}, trong đó {conferenceRecord} là mã nhận dạng duy nhất cho mỗi phiên bản của một cuộc gọi trong một không gian.

PhoneAccess

Thông tin truy cập qua điện thoại bao gồm những thông tin cần thiết để quay số vào một hội nghị bằng cách sử dụng số điện thoại theo khu vực và mã PIN dành riêng cho số điện thoại đó.

Biểu diễn dưới dạng JSON
{
  "phoneNumber": string,
  "pin": string,
  "regionCode": string,
  "languageCode": string
}
Trường
phoneNumber

string

Số điện thoại để gọi đến phòng họp này theo định dạng E.164. Số điện thoại đầy đủ có ký tự "+" ở đầu.

pin

string

Mã PIN mà người dùng phải nhập sau khi quay số đã cho. Mã PIN chỉ bao gồm các chữ số thập phân và độ dài có thể thay đổi.

regionCode

string

Mã vùng CLDR/ISO 3166 cho quốc gia được liên kết với quyền truy cập vào điện thoại này. Để được phân tích cú pháp bằng tiện ích RegionCode dành cho khâu quốc tế hoá. Ví dụ: "SE" cho Thuỵ Điển.

languageCode

string

Mã ngôn ngữ BCP 47/LDML cho ngôn ngữ được liên kết với quyền truy cập vào điện thoại này. Để được tiện ích LanguageCode i18n phân tích cú pháp. Ví dụ: "es-419" cho tiếng Tây Ban Nha (Mỹ La-tinh), "fr-CA" cho tiếng Pháp (Canada).

GatewaySipAccess

Thông tin chi tiết về cách tham gia hội nghị qua cổng SIP.

Biểu diễn dưới dạng JSON
{
  "uri": string,
  "sipAccessCode": string
}
Trường
uri

string

URI Giao thức khởi tạo phiên (SIP) mà bạn có thể truy cập vào hội nghị.

Chuỗi này có một trong các định dạng sau:

trong đó USER_ID là mã ghim chung gồm 13 chữ số (cũng có thể hỗ trợ sử dụng mã cuộc họp Meet trong tương lai) và GATEWAY_ADDRESS là một địa chỉ hợp lệ cần được phân giải bằng cách sử dụng tra cứu SRV DNS hoặc một bộ tứ dấu chấm.

sipAccessCode

string

Mã số cố định để nhập thủ công trên các thiết bị được định cấu hình đặc biệt.

Phương thức

create

Tạo một không gian.

endActiveConference

Kết thúc một hội nghị đang diễn ra (nếu có).

get

Lấy thông tin chi tiết về một không gian họp.

patch

Cập nhật thông tin chi tiết về không gian họp.