Hướng dẫn này giải thích cách sử dụng phương thức delete
trên tài nguyên membership
của API Google Chat để xoá thành viên khỏi một không gian (còn gọi là xoá
gói thành viên. Bạn không thể loại bỏ người quản lý không gian nếu họ là người quản lý không gian duy nhất
trong một không gian. Hãy chỉ định một người dùng khác làm người quản lý không gian trước khi xoá những người dùng này
gói hội viên.
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.
Đ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 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.
Xoá thành viên khỏi không gian
Cách xoá người dùng, nhóm trên Google Groups hoặc ứng dụng Chat khỏi dấu cách:
- Để xoá một người dùng hoặc nhóm trên Google Groups, hãy chỉ định trạng thái uỷ quyền
chat.memberships
phạm vi. Để xoá một ứng dụng trong Chat, hãy chỉ địnhchat.memberships.app
phạm vi uỷ quyền (ứng dụng chỉ có thể xoá phạm vi của chính ứng dụng đó hội viên; chứ không phải của các ứng dụng khác). Phương pháp hay nhất là chọn phạm vi hạn chế mà vẫn cho phép ứng dụng của bạn hoạt động. - Gọi phương thức
delete
trênmembership
tài nguyên. - Truyền
name
của gói thành viên để xoá. Nếu gói thành viên thuộc về chỉ có người quản lý không gian trong một không gian. Hãy chỉ định một người dùng khác làm người quản lý không gian trước đang xoá gói thành viên này.
Sau đây là cách xoá gói thành viên:
Python
- Trong thư mục đang làm việc, hãy tạo một tệp có tên
chat_membership_delete.py
. Đưa mã sau vào
chat_membership_delete.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.app"] def main(): ''' Authenticates with Chat API via user credentials, then deletes the 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().delete( # The membership to delete. # # 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. To delete a Chat app's membership, replace MEMBER # with app; an alias for the app calling the API. name='spaces/SPACE/members/MEMBER' ).execute() # Print Chat API's response in your command line interface. # When deleting a membership, the response body is empty. 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. Để xoá gói thành viên của một ứng dụng, hãy thay thếMEMBER
cho thành viênapp
.
Trong thư mục đang làm việc, hãy tạo và chạy mẫu:
python3 chat_membership_delete.py
Nếu thành công, nội dung phản hồi sẽ trả về tư cách thành viên cùng
'state': 'NOT_A_MEMBER'
cho biết thành viên không còn ở trong không gian.
{ "name": "spaces/SPACE/members/MEMBER", "state": "NOT_A_MEMBER" }
Chủ đề có liên quan
- Xem thông tin chi tiết về gói thành viên của một người dùng hoặc ứng dụng Chat.
- Liệt kê thành viên trong không gian.
- Cập nhật gói thành viên của người dùng trong phòng Google Chat.
- Mời hoặc thêm người dùng hay ứng dụng trong Chat vào không gian.