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 Section của API Google Chat để cập nhật một mục tùy chỉnh trong Google Chat.
Bạn chỉ có thể cập nhật các phần thuộc loại CUSTOM_SECTION. Để biết thêm thông tin, hãy xem bài viết Tạo và sắp xếp các mục trong Google Chat.
Điều kiện tiên quyết
Python
- 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 xin phép bằ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 đám mây Python.
-
Tạo thông tin đăng nhập mã ứng dụng 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.jsonvà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 phần
Để cập nhật một phần bằng xác thực người dùng, hãy truyền các thông tin sau trong yêu cầu của bạn:
- Chỉ định phạm vi uỷ quyền
chat.users.sections. - Gọi phương thức
UpdateSection. - Trong nội dung yêu cầu, hãy cung cấp một tài nguyên
Sectionvà một mặt nạ cho trường:- Đặt
namecủa phần cần cập nhật. - Đặt
displayNamethành tên mới cho mục. - Đặt
updateMaskthànhdisplayName.
- Đặt
Ví dụ sau đây cập nhật một phần:
Python
from google.cloud import chat_v1
from google.protobuf import field_mask_pb2
def update_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.UpdateSectionRequest(
section=chat_v1.Section(
name="SECTION_NAME",
display_name="NEW_SECTION_DISPLAY_NAME"
),
update_mask=field_mask_pb2.FieldMask(paths=["display_name"])
)
# Make the request
response = client.update_section(request=request)
print(response)
Để chạy mẫu này, hãy thay thế các giá trị sau:
SECTION_NAME: Tên tài nguyên của phần. Bạn có thể lấy tên tài nguyên bằng cách gọi phương thứcListSections.NEW_SECTION_DISPLAY_NAME: Tên mới của phần.
Chat API trả về phiên bản đã cập nhật của Section.
Chủ đề có liên quan
- Tạo phần kênh
- Xoá một phần
- Thay đổi vị trí của một phần
- Các phần trong danh sách
- Liệt kê các không gian trong một phần
- Di chuyển không gian sang một mục khác