Hướng dẫn này giải thích cách sử dụng
Phương thức get
đang bật
SpaceEvent
của
API Google Chat để lấy thông tin chi tiết về một sự kiện từ một phòng Google Chat.
Tài nguyên SpaceEvent
biểu thị một thay đổi đối với một không gian hoặc phần tử con của không gian đó
chẳng hạn như tin nhắn, lượt thể hiện cảm xúc và gói hội viên. Để tìm hiểu
về các loại sự kiện được hỗ trợ, hãy xem trường eventType
của
Tài nguyên SpaceEvent
tài liệu tham khảo.
Bạn có thể yêu cầu sự kiện trước thời điểm yêu cầu tối đa 28 ngày. Sự kiện
chứa phiên bản gần đây nhất của tài nguyên đã thay đổi. Ví dụ: nếu
bạn yêu cầu một sự kiện về một tin nhắn mới nhưng sau đó tin nhắn đó đã được cập nhật,
máy chủ sẽ trả về tài nguyên Message
đã cập nhật trong tải trọng sự kiện.
Để gọi phương thức này, bạn phải sử dụng hàm user xác thực. Để nhận được sự kiện, người dùng xác thực phải là thành viên của không gian nơi sự kiện diễn ra đã xảy ra.
Điều kiện tiên quyết
Python
- Doanh nghiệp Tài khoản Google Workspace 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 API Google Chat bằng tên, biểu tượng và nội dung mô tả cho ứng dụng Chat.
-
Tạo thông tin xác thực 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ãy lưu thông tin đăng nhập dưới dạng tệp JSON có tên
client_secrets.json
vào thư mục nội bộ.
- Chọn phạm vi uỷ quyền có hỗ trợ việc xác thực người dùng.
Xem thông tin chi tiết về sự kiện trên không gian
Cách xem thông tin chi tiết về SpaceEvent
trong Google Chat:
- Gọi phương thức
get
trênSpaceEvent
. - Truyền
name
củaSpaceEvent
để lấy. Lấy tênSpaceEvent
từSpaceEvent
tài nguyên/ Google Chat. - Với người dùng xác thực, chỉ định phạm vi uỷ quyền hỗ trợ loại sự kiện trong yêu cầu của bạn. Là một phương pháp hay nhất, chọn phạm vi hạn chế nhất mà vẫn cho phép ứng dụng của bạn để hoạt động.
Sau đây là cách nhận SpaceEvent
bằng
xác thực người dùng:
Python
- Trong thư mục đang làm việc, hãy tạo một tệp có tên
chat_space_event_get.py
. Đưa mã sau vào
chat_space_event_get.py
:"""Gets a SpaceEvent resource from the Chat API.""" from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ['SCOPE'] # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build( 'chat', 'v1', credentials=creds ) # Use the service endpoint to call Chat API. result = ( chat.spaces() .spaceEvents() .get( # The space event to get. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace SPACE_EVENT with a SpaceEvent name. # Obtain the spaceEvent name from the SpaceEvent resource of # Chat API. name='spaces/SPACE/spaceEvents/SPACE_EVENT' ) .execute() ) # Prints details about the created spaceEvent. print(result)
Trong mã, thay thế các nội dung sau:
SCOPE
: Phạm vi uỷ quyền dựa trên loại sự kiện. Ví dụ: nếu bạn nhận được một sự kiện trên không gian về một gói thành viên mới, hãy dùng phạm vichat.memberships.readonly
, có định dạng làhttps://www.googleapis.com/auth/chat.memberships.readonly
. Bạn có thể lấy loại sự kiện này từ Phương thứcspaces.spaceEvents.list
. Để tìm hiểu cách sử dụng phương pháp này, hãy xem Liệt kê các sự kiện của một không gian.SPACE
: Tên không gian mà bạn có thể lấy từ phương thứcspaces.list
trong API Chat hoặc qua URL của một không gian.SPACE_EVENT
: Tên không gian mà bạn có thể lấy từ Phương thứcspaces.spaceEvents.list
.
Trong thư mục đang làm việc, hãy tạo và chạy mẫu:
python3 chat_space_event_get.py
API Chat trả về một phiên bản của
SpaceEvent
kèm theo thông tin chi tiết về sự kiện.