Hướng dẫn này giải thích cách sử dụng phương thức get
trên tài nguyên membership
của API Google Chat để biết thông tin chi tiết về gói thành viên của người dùng hoặc ứng dụng Chat trong một không gian.
Tài nguyên Membership
cho biết người dùng thực hoặc ứng dụng Google Chat được mời tham gia, tham gia hay không tham gia không gian.
Việc xác thực bằng xác thực ứng dụng cho phép một ứng dụng Chat nhận gói thành viên từ các không gian mà ứng dụng đó có quyền truy cập trong Google Chat (ví dụ: các không gian mà ứng dụng là thành viên), nhưng không bao gồm gói thành viên của ứng dụng Chat, bao gồm cả thành viên của ứng dụng đó. Việc xác thực bằng xác thực người dùng sẽ trả về tư cách thành viên từ các không gian mà người dùng đã xác thực có quyền truy cập.
Điều kiện tiên quyết
Python
- Python 3.6 trở lên
- Công cụ quản lý gói pip
Các thư viện ứng dụng mới nhất của Google dành cho Python. Để cài đặt hoặc cập nhật các công cụ này, hãy chạy lệnh sau trong giao diện dòng lệnh của bạn:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Một dự án trên Google Cloud đã bật và thiết lập API Google Chat. Để biết các bước, hãy xem bài viết Tạo ứng dụng Google Chat.
Đã định cấu hình hoạt động uỷ quyền cho ứng dụng Chat. Khi có gói thành viên, bạn hỗ trợ cả hai phương thức xác thực sau:
- Xác thực người dùng với phạm vi uỷ quyền
chat.memberships.readonly
hoặcchat.memberships
. - Xác thực ứng dụng với phạm vi uỷ quyền
chat.bot
.
- Xác thực người dùng với phạm vi uỷ quyền
Xem thông tin chi tiết về gói thành viên của người dùng hoặc gói thành viên của ứng dụng Chat
Để biết thông tin chi tiết về một gói thành viên trong Google Chat, hãy chuyển những thông tin sau vào yêu cầu của bạn:
- Với tính năng xác thực ứng dụng, hãy chỉ định phạm vi uỷ quyền
chat.bot
. Với quy trình xác thực người dùng, hãy chỉ định phạm vi uỷ quyềnchat.memberships.readonly
hoặcchat.memberships
. Cách tốt nhất là 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. - Gọi phương thức
get
trên tài nguyênmembership
. - Chuyển gói thành viên
name
để có được. Lấy tên thành viên từ tài nguyên thành viên của Google Chat.
Sau đây là cách đăng ký gói thành viên bằng phương thức 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_membership_get.py
. Đưa mã sau vào
chat_membership_get.py
: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 = ["https://www.googleapis.com/auth/chat.memberships.readonly"] def main(): ''' Authenticates with Chat API via user credentials, then gets details about a specified membership. ''' # 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().members().get( # The membership 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 MEMBER with a membership name. # Obtain the membership name from the memberships resource of # Chat API. name='spaces/SPACE/members/MEMBER' ).execute() # Prints details about the membership. print(result) if __name__ == '__main__': main()
Trong mã, hãy thay thế các đoạn mã sau:
SPACE
: tên không gian mà bạn có thể lấy từ phương thứcspaces.list
trong API Chat hoặc từ URL của không gian.MEMBER
: tên thành viên mà bạn có thể lấy từ phương thứcspaces.members.list
trong API Chat.
Trong thư mục đang làm việc, hãy tạo và chạy mẫu:
python3 chat_membership_get.py
API Chat trả về một thực thể của membership
nêu chi tiết thành viên đã chỉ định.
Chủ đề có liên quan
- Liệt kê thành viên trong một không gian.
- Mời hoặc thêm người dùng hay ứng dụng Chat vào một không gian.
- Cập nhật gói thành viên của người dùng trong phòng Google Chat.
- Xoá người dùng hoặc ứng dụng Chat khỏi một không gian.