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ó dấu cách ở 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 sẽ tuỳ 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 tính năng 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. Mã nhận dạng duy nhấ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 sẽ khiến yêu cầu trở nên bất biến, đảm bảo rằng nhiều yêu cầu giống hệt nhau có cùng mã yêu cầu sẽ chỉ tạo ra một khoảng trống duy nhất. Các yêu cầu tiếp theo có cùng mã yêu cầu sẽ trả về không gian hiện có và không cập nhật không gian, ngay cả khi thông tin chi tiết được yêu cầu khác với trạng thái hiện tại.

Cách sử dụng trường này một cách hiệu quả:

  • Đảm bảo rằng các yêu cầu tiếp theo giống hệt nhau và sử dụng cùng thông tin xác thực như yêu cầu ban đầu.
  • Nếu một không gian đã được tạo bằng mã yêu cầu được cung cấp, thì yêu cầu sẽ trả về không gian đó. Xin lưu ý rằng không gian được trả về có thể chưa được điền đầy đủ; API sẽ phản hồi không gian trong yêu cầu của bạn bằng tên tài nguyên do hệ thống chỉ định. Để truy xuất siêu dữ liệu mới nhất cho không gian, hãy gọi spaces.get.
  • Việc dùng lại mã yêu cầu hiện có với một người dùng đã xác thực khác sẽ dẫn đến 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ể mới 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.