Hướng dẫn này giải thích cách sử dụng phương thức patch()
trên tài nguyên SpaceNotificationSetting
của API Google Chat để cập nhật chế độ cài đặt thông báo về không gian của người dùng.
Tài nguyên SpaceNotificationSetting
là một tài nguyên đơn lẻ, thể hiện thông tin chi tiết về chế độ cài đặt thông báo về không gian của một người dùng cụ thể.
Điều kiện tiên quyết
Node.js
- Tài khoản Google Workspace Business hoặc Enterprise có quyền truy cập vào Google Chat.
- Thiết lập môi trường:
- Tạo một dự án trên Google Cloud.
- Định cấu hình màn hình đồng ý OAuth.
- Bật và định cấu hình Google Chat API bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat của bạn.
- Cài đặt Thư viện ứng dụng Cloud Node.js.
-
Tạo thông tin đăng nhập mã ứng dụng khách OAuth cho một ứng dụng dành cho máy tính. Để chạy mẫu trong hướng dẫn này, hãy lưu thông tin đăng nhập dưới dạng tệp JSON có tên là
credentials.json
vào thư mục cục bộ của bạn.
- Chọn một phạm vi uỷ quyền hỗ trợ xác thực người dùng.
Cập nhật chế độ cài đặt thông báo về không gian của người dùng gọi
Để cập nhật chế độ cài đặt thông báo về không gian của người dùng, hãy thêm những thông tin sau vào yêu cầu của bạn:
- Chỉ định phạm vi uỷ quyền
chat.users.spacesettings
. - Gọi phương thức
UpdateSpaceNotificationSetting()
, truyền yêu cầuUpdateSpaceNotificationSetting
để chứa các thay đổi đối với chế độ cài đặt thông báo. Yêu cầu này bao gồm:spaceNotificationSetting
có các thuộc tính sau:- Thuộc tính
name
chỉ định chế độ cài đặt thông báo không gian cần cập nhật, bao gồm cả mã nhận dạng người dùng hoặc biệt hiệu và mã nhận dạng không gian. Việc cập nhật chế độ cài đặt thông báo về không gian chỉ hỗ trợ việc cập nhật chế độ cài đặt thông báo của người dùng gọi. Bạn có thể chỉ định chế độ này bằng cách đặt một trong những chế độ sau:- Bí danh
me
. Ví dụ:users/me/spaces/SPACE/spaceNotificationSetting
. - Địa chỉ email Workspace của người dùng gọi. Ví dụ:
users/user@example.com/spaces/SPACE/spaceNotificationSetting
. - Mã nhận dạng người dùng của người dùng gọi. Ví dụ:
users/USER/spaces/SPACE/spaceNotificationSetting
.
- Bí danh
notificationSetting
: đặt cấp độ thông báo, chẳng hạn nhưALL
,OFF
.muteSetting
: đặt trạng thái tắt hoặc bật tiếng, giá trị có thể làMUTED
hoặcUNMUTED
.
- Thuộc tính
updateMask
: đặt các trường cập nhật, có thể bao gồmnotification_setting
,mute_setting
.
Ví dụ sau đây cập nhật chế độ cài đặt thông báo về không gian của người dùng gọi:
Node.js
Để chạy mẫu này, hãy thay thế SPACE_NAME
bằng mã nhận dạng của name
của không gian.
Bạn có thể lấy mã nhận dạng bằng cách gọi phương thức ListSpaces()
hoặc từ URL của không gian.
Google Chat API sẽ cập nhật chế độ cài đặt thông báo của không gian được chỉ định và trả về một phiên bản của SpaceNotificationSetting
.