Tạo không gian. Có thể dùng để tạo không gian có tên hoặc cuộc trò chuyện nhóm trong Import mode. Để biết ví dụ, hãy xem bài viết Tạo không gian.
Hỗ trợ các loại xác thực sau:
Khi xác thực dưới dạng ứng dụng, bạn phải đặt trường space.customer trong yêu cầu.
Quyền thành viên của không gian khi tạo phụ thuộc vào việc không gian được tạo trong Import mode hay không:
- Chế độ nhập: Không tạo thành viên nào.
- Tất cả chế độ khác: Người dùng gọi được thêm làm thành viên. Đó là:
- Chính ứng dụng khi sử dụng tính năng xác thực ứng dụng.
- Người dùng khi sử dụng phương thức xác thực người dùng.
Nếu bạn nhận được thông báo lỗi ALREADY_EXISTS khi tạo không gian, 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.
Yêu cầu HTTP
POST https://chat.googleapis.com/v1/spaces
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
| Tham số | |
|---|---|
request |
Không bắt buộc. Giá trị nhận dạng duy nhất cho yêu cầu này. Bạn nên dùng UUID ngẫu nhiên. Việc chỉ định mã yêu cầu hiện có sẽ trả về không gian được tạo bằng mã đó thay vì tạo không gian mới. Việc chỉ định mã yêu cầu hiện có từ cùng một ứng dụng Chat với một người dùng đã xác thực khác sẽ trả về lỗi. |
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của Space.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một thực thể Space mới tạo.
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/chat.app.spaces.createhttps://www.googleapis.com/auth/chat.app.spaceshttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.spaceshttps://www.googleapis.com/auth/chat.spaces.create
Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.