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
về API Google Chat để xem thông tin chi tiết về gói thành viên trong một không gian.
Chiến lược phát hành đĩa đơn
Tài nguyên Membership
cho biết liệu người dùng thực hoặc ứng dụng Google Chat có được mời tham gia hay không,
một phần hoặc không có trong không gian.
Xác thực với xác thực ứng dụng cho phép ứng dụng Chat nhận tư cách thành viên từ các không gian mà ứng dụng này có quyền truy cập trong Google Chat (ví dụ: các không gian mà thành viên tham gia), nhưng không bao gồm Gói thành viên trong ứng dụng Chat, bao gồm cả gói thành viên của chính ứng dụng đó. Đang xác thực thông qua tính năng xác thực người dùng trả về thành viên từ 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
- 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.
- Cài đặt Python Thư viện ứng dụng API của Google.
- Tạo thông tin xác thực truy cập dựa trên cách bạn muốn xác thực trong API Google Chat
yêu cầu:
- Cách xác thực là người dùng Chat:
tạo mã ứng dụng OAuth
thông tin xác thực và 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 địa phương của bạn. - Cách xác thực là ứng dụng Chat:
tạo tài khoản dịch vụ
thông tin xác thực và lưu thông tin đăng nhập dưới dạng tệp JSON có tên
credentials.json
.
- Cách xác thực là người dùng Chat:
tạo mã ứng dụng OAuth
thông tin xác thực và lưu thông tin đăng nhập dưới dạng tệp JSON có tên
- Chọn phạm vi uỷ quyền dựa trên việc bạn muốn xác thực là người dùng hay Ứng dụng Chat.
Xem chi tiết về gói thành viên
Để biết thông tin chi tiết về một gói thành viên trong Google Chat, hãy chuyển các thông tin sau vào yêu cầu:
- Bằng
xác thực ứng dụng, chỉ định
phạm vi uỷ quyền
chat.bot
. Bằng xác thực người dùng, chỉ định lệnh uỷ quyềnchat.memberships.readonly
hoặcchat.memberships
phạm vi. Phương pháp hay 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ênmembership
tài nguyên. - Hãy vượt qua
name
của gói thành viên để nhận. Lấy tên thành viên từ tài nguyên dành cho thành viên của Google Chat.
Sau đây là cách đăng ký gói thành viên qua 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ã, thay thế các nội dung 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 qua URL của một không gian.MEMBER
: tên thành viên 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 phiên bản của
membership
nêu chi tiết gói thành viên đã chỉ định.
Chủ đề có liên quan
- Liệt kê thành viên trong không gian.
- Mời hoặc thêm người dùng hay ứng dụng trong Chat vào 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 trong Chat khỏi không gian.