REST Resource: spaces

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} đại diện cho 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 của một không gian. Chỉ có đầu ra cho các trường hợp 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 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 phân thành 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 có 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. 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. Thông tin đầu vào 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 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 thông thường (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 bất kỳ người dùng Google Chat nào tham gia.

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

enum (SpaceThreadingState)

Chỉ có đầu ra. Trạng thái 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 cả 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 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 không gian đang được nhập, người dùng sẽ không nhìn thấy không gian cho đến khi quá trình nhập hoàn tất.

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

string (Timestamp format)

Không bắt buộc. Không thể thay đổi. Đối với không gian được tạo trong Chat, thời gian không gian được tạo. Trường này chỉ có thể xuất, ngoại trừ khi được 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 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 tin nhắn trực tiếp bằng ứng dụng Chat.

Để hỗ trợ quản trị viên cài đặt, ứ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 sẵ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.

enum (SpaceSessionState)

Chỉ có đầu ra. Trạng thái phiên của không gian.

string (Timestamp format)

Chỉ có đầu ra. Dấu thời gian khi trạng thái hỗ trợ phiên của không gian chuyển thành được hỗ trợ. Không đặt nếu không gian không bật tính năng hỗ trợ phiên.

string (Timestamp format)

Chỉ có đầu ra. Thời điểm hệ thống sẽ tự động xoá không gian nếu không gian đó vẫn ở chế độ nhập.

Mỗi không gian được tạo ở chế độ nhập phải thoát khỏi chế độ này trước thời gian hết hạn bằng cách sử dụng spaces.completeImport.

Trường này chỉ được điền sẵn cho những không gian được tạo bằng chế độ nhập.

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 bằng phương thứ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 từ tài nguyên khách hàng của SDK dành cho quản trị viên. Ứ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.

Trường này không được điền sẵn cho tin nhắn trực tiếp (DM) hoặc khi không gian do người dùng không sử dụng Google Workspace tạo.

enum (PredefinedPermissionSettings)

Không bắt buộc. Chỉ có đầu vào. Chế độ cài đặt bộ quyền 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, một không gian cộng tác sẽ được tạo. Sau khi bạn tạo không gian, các chế độ cài đặt sẽ được điền vào trường PermissionSettings.

Việc đặt bộ quyền được xác định trước sẽ hỗ trợ:

• Xác thực ứng dụng có sự phê duyệt của quản trị viên với phạm vi chat.app.spaces hoặc chat.app.spaces.create.

• Xác thực người dùng

object (PermissionSettings)

Không bắt buộc. Chế độ cài đặt bộ quyền cho không gian hiện có. Thông tin đầu vào để cập nhật bộ quyền chính xác trong không gian, trong đó bộ 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.

Việc đọc và cập nhật chế độ cài đặt quyền hỗ trợ:

• Xác thực ứng dụng có sự phê duyệt của quản trị viên với phạm vi chat.app.spaces. Chỉ được điền sẵn và có thể thiết lập khi ứng dụng Chat tạo không gian.

• Xác thực người dùng