Method: spaces.create

Tạo một không gian. Có thể dùng để tạo một không gian có tên hoặc một cuộc trò chuyện nhóm trong Import mode. Để biết ví dụ, hãy xem phần Tạo không gian.

Hỗ trợ các loại xác thực sau:

  • Xác thực ứng dụng bằng sự phê duyệt của quản trị viên và một trong các phạm vi uỷ quyền sau:

    • https://www.googleapis.com/auth/chat.app.spaces.create
    • https://www.googleapis.com/auth/chat.app.spaces
  • Xác thực người dùng bằng một trong các phạm vi uỷ quyền sau:

    • https://www.googleapis.com/auth/chat.spaces.create
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (chỉ có khoảng trắng ở chế độ nhập)

Khi xác thực dưới dạng một ứng dụng, bạn phải đặt trường space.customer trong yêu cầu.

Khi xác thực dưới dạng một ứng dụng, ứng dụng Chat sẽ được thêm làm thành viên của không gian. Tuy nhiên, không giống như xác thực người dùng, ứng dụng Chat không được thêm làm người quản lý không gian. Theo mặc định, tất cả thành viên không gian đều có thể xoá ứng dụng Chat khỏi không gian. Để chỉ cho phép người quản lý không gian xoá ứng dụng khỏi một không gian, hãy đặt space.permission_settings.manage_apps thành managersAllowed.

Khi tạo không gian, việc có nhóm thành viên hay không phụ thuộc vào việc không gian đó được tạo trong Import mode hay không:

  • Chế độ nhập: Không có thành viên nào được tạo.
  • Tất cả các chế độ khác: Người dùng gọi được thêm làm thành viên. Đây 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 là con người khi sử dụng quy trình 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 một 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

Thông số
requestId

string

Không bắt buộc. Giá trị nhận dạng riêng biệt cho yêu cầu này. Bạn nên dùng một UUID ngẫu nhiên. Việc chỉ định một mã yêu cầu hiện có sẽ trả về không gian được tạo bằng mã đó thay vì tạo một không gian mới. Việc chỉ định một 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 phiên bản mới được tạo của Space.

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.create
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.