REST Resource: spaces

{
  "name": string,
  "type": enum (Type),
  "spaceType": enum (SpaceType),
  "singleUserBotDm": boolean,
  "threaded": boolean,
  "displayName": string,
  "externalUserAllowed": boolean,
  "spaceThreadingState": enum (SpaceThreadingState),
  "spaceDetails": {
    object (SpaceDetails)
  },
  "spaceHistoryState": enum (HistoryState),
  "importMode": boolean,
  "createTime": string,
  "lastActiveTime": string,
  "adminInstalled": boolean,
  "membershipCount": {
    object (MembershipCount)
  },
  "accessSettings": {
    object (AccessSettings)
  },
  "spaceUri": string,
  "customer": string,

  // Union field space_permission_settings can be only one of the following:
  "predefinedPermissionSettings": enum (PredefinedPermissionSettings),
  "permissionSettings": {
    object (PermissionSettings)
  }
  // End of list of possible types for union field space_permission_settings.
}

string

Tên tài nguyên của không gian.

Định dạng spaces/{space}

Trong đó {space} biểu thị mã nhận dạng do hệ thống chỉ định cho không gian. Bạn có thể lấy mã không gian bằng cách gọi phương thức spaces.list() hoặc từ URL của không gian. Ví dụ: nếu URL của không gian là https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA, thì mã không gian là AAAAAAAAA.

enum (Type)

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng spaceType. Loại không gian.

enum (SpaceType)

Loại không gian. Bắt buộc khi tạo không gian hoặc cập nhật loại không gian. Chỉ có đầu ra cho các mục đích sử dụng khác.

boolean

Không bắt buộc. Liệu không gian đó có phải là tin nhắn trực tiếp giữa một ứng dụng Chat và một người dùng hay không.

boolean

Chỉ có đầu ra. Không dùng nữa: Chuyển sang dùng spaceThreadingState. Liệu thư có được tạo chuỗi trong không gian này hay không.

string

Tên hiển thị của không gian. Bắt buộc khi tạo không gian bằng spaceType là SPACE. Nếu bạn nhận được thông báo lỗi ALREADY_EXISTS khi tạo không gian hoặc cập nhật displayName, hãy thử một displayName khác. Một không gian hiện có trong tổ chức trên Google Workspace có thể đã sử dụng tên hiển thị này.

Đối với tin nhắn trực tiếp, trường này có thể trống.

Hỗ trợ tối đa 128 ký tự.

boolean

Không thể thay đổi. Liệu không gian này có cho phép bất kỳ người dùng Google Chat nào làm thành viên hay không. Nhập dữ liệu khi tạo không gian trong một tổ chức trên Google Workspace. Bỏ qua trường này khi tạo khoảng trắng trong các điều kiện sau:

• Người dùng đã xác thực sử dụng tài khoản người dùng cá nhân (tài khoản người dùng không được quản lý). Theo mặc định, không gian do tài khoản người dùng cá nhân tạo sẽ cho phép mọi người dùng Google Chat.

Đối với các không gian hiện có, trường này chỉ có đầu ra.

enum (SpaceThreadingState)

Chỉ có đầu ra. Trạng thái tạo chuỗi tin nhắn trong không gian Chat.

object (SpaceDetails)

Thông tin chi tiết về không gian, bao gồm nội dung mô tả và quy tắc.

enum (HistoryState)

Trạng thái nhật ký tin nhắn của tin nhắn và chuỗi tin nhắn trong không gian này.

boolean

Không bắt buộc. Liệu không gian này có được tạo trong Import Mode trong quá trình di chuyển dữ liệu sang Google Workspace hay không. Trong khi quá trình nhập diễn ra, người dùng sẽ không thấy các không gian đó cho đến khi quá trình nhập hoàn tất.

Bạn cần xác thực người dùng để tạo không gian trong Import Mode.

string (Timestamp format)

Không bắt buộc. Không thể thay đổi. Thời gian tạo không gian đối với các không gian được tạo trong Chat. Trường này chỉ xuất, ngoại trừ khi được sử dụng trong không gian ở chế độ nhập.

Đối với không gian ở chế độ nhập, hãy đặt trường này thành dấu thời gian trước đây khi không gian được tạo trong nguồn để duy trì thời gian tạo ban đầu.

Chỉ được điền sẵn vào kết quả khi spaceType là GROUP_CHAT hoặc SPACE.

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian của tin nhắn cuối cùng trong không gian.

boolean

Chỉ có đầu ra. Đối với những không gian nhắn tin trực tiếp (DM) có ứng dụng Chat, thông tin cho biết không gian đó có phải do quản trị viên Google Workspace tạo hay không. Quản trị viên có thể thay mặt người dùng trong tổ chức cài đặt và thiết lập tin nhắn trực tiếp bằng ứng dụng Chat.

Để hỗ trợ tính năng cài đặt cho quản trị viên, ứng dụng Chat của bạn phải có tính năng nhắn tin trực tiếp.

object (MembershipCount)

Chỉ có đầu ra. Số lượng gói thành viên đã tham gia được nhóm theo loại thành viên. Được điền khi spaceType là SPACE, DIRECT_MESSAGE hoặc GROUP_CHAT.

object (AccessSettings)

Không bắt buộc. Chỉ định chế độ cài đặt quyền truy cập của không gian. Chỉ được điền khi spaceType là SPACE.

string

Chỉ có đầu ra. URI để người dùng truy cập vào không gian.

string

Không bắt buộc. Không thể thay đổi. Mã khách hàng của miền của không gian. Chỉ bắt buộc khi tạo không gian có xác thực ứng dụng và SpaceType là SPACE, nếu không thì không nên đặt.

Ở định dạng customers/{customer}, trong đó customer là id trong [Tài nguyên khách hàng của SDK dành cho quản trị viên]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Các ứng dụng riêng tư cũng có thể sử dụng bí danh customers/my_customer để tạo không gian trong cùng một tổ chức trên Google Workspace với ứng dụng.

Đối với tin nhắn trực tiếp, trường này không được điền sẵn.

enum (PredefinedPermissionSettings)

Không bắt buộc. Chỉ nhập. Chế độ cài đặt quyền cho không gian được xác định trước, chỉ nhập khi tạo không gian. Nếu bạn không đặt trường này, hệ thống sẽ tạo một không gian cộng tác. Sau khi bạn tạo không gian, các chế độ cài đặt sẽ được điền sẵn vào trường PermissionSettings.

object (PermissionSettings)

Không bắt buộc. Chế độ cài đặt quyền đối với không gian cho các không gian hiện có. Dữ liệu đầu vào để cập nhật chế độ cài đặt quyền chính xác cho không gian, trong đó chế độ cài đặt quyền hiện tại sẽ được thay thế. Dữ liệu đầu ra liệt kê các chế độ cài đặt hiện tại của quyền.