Hướng dẫn này giải thích cách sử dụng phương thức create trên tài nguyên Section của API Google Chat để tạo một mục tùy chỉnh mới trong Google Chat.
Các phần giúp người dùng nhóm các cuộc trò chuyện và tuỳ chỉnh danh sách không gian xuất hiện trong bảng điều hướng của Google Chat. Để 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.
Tạo phần kênh
Để tạo một phần có 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
CreateSection. - Trong nội dung yêu cầu, hãy cung cấp một tài nguyên
Section:- Đặt
displayNamethành tên của phần (tối đa 80 ký tự). - Đặt
typethànhCUSTOM_SECTION.
- Đặt
Ví dụ sau đây tạo một phần:
Python
from google.cloud import chat_v1
def create_section():
# Create a client
client = chat_v1.ChatServiceClient()
# Initialize request
request = chat_v1.CreateSectionRequest(
parent="users/me",
section=chat_v1.Section(
display_name="SECTION_DISPLAY_NAME",
type=chat_v1.Section.SectionType.CUSTOM_SECTION
)
)
# Make the request
response = client.create_section(request=request)
print(response)
Để chạy mẫu này, hãy thay thế các giá trị sau:
SECTION_DISPLAY_NAME: Tên của phần mới.
Chat API trả về một thực thể của Section cho biết chi tiết về phần đã được tạo.
Chủ đề có liên quan
- Cập nhật một phần
- 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