Method: spaces.patch

Cập nhật không gian. Để biết ví dụ, hãy xem bài viết Cập nhật không gian.

Nếu bạn đang cập nhật trường displayName và nhận được thông báo lỗi ALREADY_EXISTS, hãy thử dùng một tên hiển thị khác. Một không gian hiện có trong tổ chức trên Google Workspace có thể đã sử dụng tên hiển thị này.

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

Yêu cầu HTTP

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
space.name

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ã 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ã không gian là AAAAAAAAA.

Tham số truy vấn

Thông số
updateMask

string (FieldMask format)

Bắt buộc. Các đường dẫn trường đã cập nhật, được phân tách bằng dấu phẩy nếu có nhiều đường dẫn.

Bạn có thể cập nhật các trường sau đây cho một không gian:

spaceDetails: Cập nhật nội dung mô tả của không gian. Hỗ trợ tối đa 150 ký tự.

displayName: Chỉ hỗ trợ cập nhật tên hiển thị cho những không gian có trường spaceType là SPACE. Nếu bạn nhận được thông báo lỗi ALREADY_EXISTS, hãy thử một giá trị 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.

spaceType: Chỉ hỗ trợ thay đổi loại không gian GROUP_CHAT thành SPACE. Thêm displayName cùng với spaceType vào mặt nạ cập nhật và đảm bảo rằng không gian được chỉ định có tên hiển thị không trống và loại không gian SPACE. Bạn không bắt buộc phải thêm mặt nạ spaceType và loại SPACE vào không gian được chỉ định khi cập nhật tên hiển thị nếu không gian hiện có đã có loại SPACE. Việc cố gắng cập nhật loại không gian theo cách khác sẽ dẫn đến lỗi đối số không hợp lệ. useAdminAccess không hỗ trợ spaceType.

spaceHistoryState: Cập nhật chế độ cài đặt nhật ký của không gian bằng cách bật hoặc tắt nhật ký của không gian. Chỉ được hỗ trợ nếu chế độ cài đặt nhật ký được bật cho tổ chức Google Workspace. Để cập nhật trạng thái nhật ký của không gian, bạn phải bỏ qua tất cả mặt nạ trường khác trong yêu cầu của mình. spaceHistoryState không được hỗ trợ với useAdminAccess.

accessSettings.audience: Cập nhật chế độ cài đặt quyền truy cập về những người có thể khám phá không gian, tham gia không gian và xem trước tin nhắn trong không gian có tên, trong đó trường spaceType là SPACE. Nếu không gian hiện tại có đối tượng mục tiêu, bạn có thể xoá đối tượng đó và hạn chế quyền truy cập vào không gian bằng cách bỏ qua giá trị cho mặt nạ trường này. Để cập nhật chế độ cài đặt quyền truy cập cho một không gian, người dùng xác thực phải là người quản lý không gian và bỏ qua tất cả các mặt nạ trường khác trong yêu cầu của bạn. Bạn không thể cập nhật trường này nếu không gian đang ở chế độ nhập. Để tìm hiểu thêm, hãy xem bài viết Để người dùng cụ thể tìm thấy không gian. accessSettings.audience không được hỗ trợ với useAdminAccess.

permissionSettings: Hỗ trợ thay đổi chế độ cài đặt quyền của một không gian. Khi cập nhật chế độ cài đặt quyền, bạn chỉ có thể chỉ định mặt nạ trường permissionSettings; bạn không thể cập nhật mặt nạ trường khác cùng một lúc. permissionSettings không được hỗ trợ với useAdminAccess. Các mặt nạ trường được hỗ trợ bao gồm:

  • permissionSettings.manageMembersAndGroups
  • permissionSettings.modifySpaceDetails
  • permissionSettings.toggleHistory
  • permissionSettings.useAtMentionAll
  • permissionSettings.manageApps
  • permissionSettings.manageWebhooks
  • permissionSettings.replyMessages
useAdminAccess

boolean

Không bắt buộc. Khi true, phương thức này sẽ chạy bằng các đặc quyền quản trị viên Google Workspace của người dùng.

Người dùng gọi phải là quản trị viên Google Workspace có đặc quyền quản lý cuộc trò chuyện và cuộc trò chuyện trong không gian.

Yêu cầu phạm vi OAuth 2.0 chat.admin.spaces.

Một số giá trị FieldMask không được hỗ trợ khi sử dụng quyền quản trị. Để biết thông tin chi tiết, hãy xem phần mô tả về updateMask.

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

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