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

Giá trị nhận dạng. Tên tài nguyên của không gian.

Định dạng spaces/{space}

Trong đó {space} là 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: Hãy sử dụng spaceType. Loại không gian.

enum (SpaceType)

Không bắt buộc. 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: Hãy sử dụng spaceThreadingState. Liệu tin nhắn có được sắp xếp theo chuỗi trong không gian này hay không.

string

Không bắt buộc. Tên hiển thị của không gian. Bắt buộc khi tạo không gian với 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 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 bắt buộc. Không thể thay đổi. 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. Thông tin đầu vào khi tạo không gian trong một tổ chức Google Workspace. Bỏ qua trường này khi tạo không gian 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, một 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 tham gia.

Đố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)

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

enum (HistoryState)

Không bắt buộc. Trạng thái nhật ký tin nhắn cho các 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. Đối với những không gian được tạo trong Chat, thời gian tạo không gian. 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 tại thời điểm không gian được tạo trong nguồn để giữ nguyên thời gian tạo ban đầu.

Chỉ được điền sẵn trong 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 gần đây nhất trong không gian.

boolean

Chỉ có đầu ra. Đối với không gian tin nhắn trực tiếp (DM) có ứng dụng Chat, liệu 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 tính năng tin nhắn trực tiếp bằng một ứ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 sẵ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 được đặt.

Ở định dạng customers/{customer}, trong đó customer là id từ [tài nguyên khách hàng SDK quản trị]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Ứ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 Google Workspace với ứng dụng.

Đối với tin nhắn riêng, 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 trong 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ế. Kết quả sẽ liệt kê các chế độ cài đặt quyền hiện tại.