Xoá thành viên khỏi không gian

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ể xoá 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

  • Python 3.6 trở lên
  • pip công cụ quản lý gói
  • Các thư viện ứng dụng mới nhất của Google dành cho Python. Cách cài đặt hoặc cập nhật các tính năng này: chạy lệnh sau trong giao diện dòng lệnh:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    
  • Một dự án trên Google Cloud đã bật và định cấu hình API Google Chat. Để biết các bước thực hiện, hãy xem Tạo ứng dụng Google Chat.
  • Đã định cấu hình uỷ quyền cho ứng dụng Chat. Đang xoá cần có gói thành viên Xác thực người dùng với Phạm vi uỷ quyền chat.memberships hoặc chat.memberships.app từ một người dùng có quyền xoá tư cách thành viên đã chỉ định.

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ỉ định chat.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ên membership 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

  1. Trong thư mục đang làm việc, hãy tạo một tệp có tên chat_membership_delete.py.
  2. Đư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()
    
  3. 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ức spaces.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ức spaces.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ên app.

  4. 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"
}