REST Resource: spaces

Tài nguyên: Không gian

Một không gian trong Google Chat. Không gian là cuộc trò chuyện giữa hai người dùng hoặc nhiều tin nhắn 1:1 giữa một người dùng và một ứng dụng Chat.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "type": enum (Type),
  "spaceType": enum (SpaceType),
  "singleUserBotDm": boolean,
  "threaded": boolean,
  "displayName": string,
  "spaceThreadingState": enum (SpaceThreadingState),
  "spaceDetails": {
    object (SpaceDetails)
  },
  "spaceHistoryState": enum (HistoryState),
  "adminInstalled": boolean
}
Các trường
name

string

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

Định dạng: space/{space}
type
(deprecated)

enum (Type)

Chỉ đầu ra. Ngưng dùng: Sử dụng singleUserBotDm hoặc spaceType (bản dùng thử cho nhà phát triển).

Loại không gian.
spaceType

enum (SpaceType)

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

singleUserBotDm

boolean

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

boolean

Chỉ đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng spaceThreadingState. Liệu thư có được tạo chuỗi trong không gian này hay không.
displayName

string

Tên hiển thị của không gian. Bắt buộc khi tạo không gian.

Đố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ự.
spaceThreadingState

enum (SpaceThreadingState)

Chỉ đầu ra. Trạng thái của chuỗi tin nhắn trong phòng Chat.
spaceDetails

object (SpaceDetails)

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

enum (HistoryState)

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.

adminInstalled

boolean

Chỉ đầu ra. Quản trị viên Google Workspace có cài đặt ứng dụng Chat hay không. Quản trị viên có thể cài đặt một ứng dụng nhắn tin cho miền, đơn vị tổ chức hoặc một nhóm người dùng của họ.

Quản trị viên chỉ có thể cài đặt các ứng dụng nhắn tin để nhắn tin trực tiếp giữa người dùng và ứng dụng. Để hỗ trợ việc cài đặt ứng dụng quản trị, ứng dụng của bạn phải có tính năng nhắn tin trực tiếp.

Loại

Đã ngừng hoạt động: Loại không gian. Thay vào đó, hãy sử dụng singleUserBotDm hoặc spaceType (bản dùng thử cho nhà phát triển).

Enum
TYPE_UNSPECIFIED
ROOM Cuộc trò chuyện giữa hai người trở lên.
DM Tin nhắn trực tiếp 1:1 giữa người dùng và ứng dụng Chat, trong đó tất cả tin nhắn đều phẳng. Xin lưu ý rằng danh sách này không bao gồm tin nhắn trực tiếp giữa hai người.

Loại không gian

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

Enum
SPACE_TYPE_UNSPECIFIED Đã đặt chỗ.
SPACE Nơi mọi người gửi tin nhắn, chia sẻ tệp và cộng tác. SPACE có thể bao gồm các ứng dụng trong Chat.
GROUP_CHAT Cuộc trò chuyện nhóm giữa 3 người trở lên. GROUP_CHAT có thể bao gồm các ứng dụng trong Chat.
DIRECT_MESSAGE Tin nhắn 1:1 giữa hai người hoặc một người và một ứng dụng Chat.

Trạng thái luồng không gian

Chỉ định loại trạng thái tạo chuỗi trong phòng Chat.

Enum
SPACE_THREADING_STATE_UNSPECIFIED Đã đặt chỗ.
THREADED_MESSAGES Các không gian được đặt tên hỗ trợ chuỗi tin nhắn. Khi trả lời một tin nhắn, người dùng có thể trả lời trong chuỗi tin nhắn, khiến tin nhắn trả lời luôn ở mức phù hợp.
GROUPED_MESSAGES Không gian được đặt tên nơi sắp xếp cuộc trò chuyện theo chủ đề. Các chủ đề và câu trả lời trong chủ đề đó được nhóm lại với nhau.
UNTHREADED_MESSAGES Tin nhắn trực tiếp (DM) giữa hai người và các cuộc trò chuyện nhóm giữa 3 người trở lên.

Chi tiết về không gian

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

Biểu diễn dưới dạng JSON 
{
  "description": string,
  "guidelines": string
}
Các trường
description

string

Không bắt buộc. Mô tả không gian. Nó có thể mô tả chủ đề, mục đích hoạt động hoặc người tham gia của không gian.

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

string

Không bắt buộc. Quy tắc, kỳ vọng và nghi thức của không gian.

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

Trạng thái lịch sử

Trạng thái nhật ký của tin nhắn và không gian. Chỉ định khoảng thời gian lưu giữ tin nhắn và chuỗi trò chuyện sau khi tạo.

Enum
HISTORY_STATE_UNSPECIFIED Giá trị mặc định. Không được dùng.
HISTORY_OFF Nhật ký đang tắt. Tin nhắn và chuỗi tin nhắn được lưu giữ trong 24 giờ.
HISTORY_ON Bật nhật ký hoạt động. Quy tắc lưu giữ trên Vault của tổ chức chỉ định thời gian lưu giữ tin nhắn và chuỗi.

Phương pháp

create

 Tạo một không gian có tên.

delete

 Xoá không gian có tên.

get

 Trả về một dấu cách.

list

 Liệt kê các không gian có người gọi là thành viên.

patch

 Cập nhật không gian.

setup

 Tạo không gian và thêm người dùng được chỉ định vào không gian.