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} 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ã nhận dạng 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ã nhận dạng 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)

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 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 ứ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: Thay vào đó, hãy sử dụng spaceThreadingState. 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 một 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 một 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 mọi người dùng Google Chat 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, không gian do tài khoản người dùng cá nhân tạo 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 theo chuỗi trong phòng 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 của 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 quá trình 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 phải 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, đây là thời gian tạo không gian. Trường này chỉ có đầu ra, trừ trường hợp được dùng trong các không gian ở chế độ nhập.

Đối với các không gian ở chế độ nhập, hãy đặt trường này thành dấu thời gian trong quá khứ 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 đầu ra 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, 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ể cài đặt và thiết lập tin nhắn trực tiếp với một ứng dụng Chat thay cho người dùng trong tổ chức của họ.

Để hỗ trợ tính năng cài đặt của 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 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.

string (Timestamp format)

Chỉ có đầu ra. Thời gian 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 một không gian có xác thực ứng dụng và SpaceType là SPACE, nếu không thì bạn không nên đặt.

Theo định dạng customers/{customer}, trong đó customer là id từ tài nguyên khách hàng Admin SDK. 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 Google Workspace với ứng dụng.

Đối với DM, trường này không được điền sẵn.

enum (PredefinedPermissionSettings)

Không bắt buộc. Chỉ có đầu vào. Chế độ cài đặt quyền đối với 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 sẵn trong trường PermissionSettings.

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

• Xác thực ứng dụng bằng sự phê duyệt của quản trị viên với các 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 quyền truy cập vào không gian đối với các không gian hiện có. Đầu vào để cập nhật chế độ cài đặt quyền truy cập chính xác vào không gian, trong đó chế độ cài đặt quyền hiện có sẽ được thay thế. Kết quả xuất ra 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 bằng 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ể đặt khi ứng dụng Chat tạo không gian.

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