Method: spaces.patch

Cập nhật một không gian. Để biết ví dụ, hãy xem phần 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ử một tên hiển thị 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.

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

  • 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
    • https://www.googleapis.com/auth/chat.import (chỉ có khoảng trắng ở chế độ nhập)
    • Xác thực người dùng cấp đặc quyền quản trị khi một tài khoản quản trị xác thực, useAdminAccess là true và phạm vi uỷ quyền sau đây được dùng:
      • https://www.googleapis.com/auth/chat.admin.spaces

Tính năng xác thực ứng dụng có các hạn chế sau:

  • Để cập nhật space.predefined_permission_settings hoặc space.permission_settings, ứng dụng phải là ứng dụng của nhà sáng tạo không gian.
  • Không hỗ trợ việc cập nhật space.access_settings.audience cho hoạt động xác thực ứng dụng.

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ã nhận dạng 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ã nhận dạng không gian là AAAAAAAAA.

Tham số truy vấn

Thông số
updateMask

string (FieldMask format)

Bắt buộ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 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ợ việc 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 đã chỉ định khi cập nhật tên hiển thị nếu không gian hiện tại đã 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ệ. spaceType không được hỗ trợ với useAdminAccess.

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ý cho 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ả cá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 Cho phép một số người dùng 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 permissionSettings mặt nạ trường; bạn không thể cập nhật các 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 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à không gian trên Chat.

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

Một số giá trị FieldMask không được hỗ trợ khi sử dụng quyền truy cập của quản trị viên. Để 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.