Z tego przewodnika dowiesz się, jak za pomocą metody delete
w zasobie membership
interfejsu Google Chat API usunąć użytkownika lub aplikację Google Chat z pokoju, zwanego też usuwaniem członkostwa. Menedżerów pokoju nie można usunąć, jeśli jest on jedynym menedżerem pokoju w pokoju. Zanim usuniesz te osoby, przypisz innego użytkownika jako menedżera pokoju.
Zasób Membership
wskazuje, czy użytkownik został zaproszony do pokoju, użytkownik lub aplikacja Google Chat został(a) zaproszony(a) lub nie ma go w pokoju.
Wymagania wstępne
Python
- Python 3.6 lub nowszy
- Narzędzie do zarządzania pakietami pip
Najnowsze biblioteki klienta Google do języka Python. Aby je zainstalować lub zaktualizować, uruchom w interfejsie wiersza poleceń to polecenie:
pip3 install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib oauth2client
Opublikowana aplikacja Google Chat. Aby utworzyć i opublikować aplikację do obsługi czatu, przeczytaj artykuł Tworzenie aplikacji Google Chat.
Autoryzacja skonfigurowana dla aplikacji do obsługi czatu wymaga uwierzytelniania użytkownika z zakresem autoryzacji
chat.memberships
lubchat.memberships.app
od użytkownika, który ma uprawnienia do usuwania określonej subskrypcji.
Usuwanie użytkownika lub aplikacji do obsługi czatu z pokoju
Aby usunąć użytkownika lub aplikację do obsługi czatu z pokoju:
- Aby usunąć użytkownika, określ zakres autoryzacji
chat.memberships
. Aby usunąć aplikację do obsługi czatu, określ zakres autoryzacjichat.memberships.app
(aplikacje mogą usuwać tylko własne członkostwo, a nie innych aplikacji). Sprawdzoną metodą jest wybranie najbardziej restrykcyjnego zakresu, który umożliwia działanie aplikacji. - Wywołaj metodę
delete
w zasobiemembership
. - Przekaż
name
subskrypcji, aby ją usunąć. Jeśli członkostwo należy do jedynego menedżera pokoju w pokoju, zanim usuniesz tę subskrypcję, przypisz do niego innego użytkownika jako menedżera pokoju.
Aby usunąć subskrypcję:
Python
- W katalogu roboczym utwórz plik o nazwie
chat_membership_delete.py
. Umieść ten kod w pliku
chat_membership_delete.py
:import os.path from google.auth.transport.requests import Request from google.oauth2.credentials import Credentials from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build from googleapiclient.errors import HttpError # 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()
W kodzie zastąp następujący fragment:
SPACE
: nazwa pokoju, którą można uzyskać, korzystając z metodyspaces.list
w Chat API lub z adresu URL pokoju.MEMBER
: nazwa subskrypcji, którą można uzyskać w metodziespaces.members.list
w Chat API. Aby usunąć członkostwo aplikacji, zastąpMEMBER
wartościąapp
.
W katalogu roboczym skompiluj i uruchom przykład:
python3 chat_membership_delete.py
Jeśli operacja się uda, treść odpowiedzi zwróci członkostwo z wartością 'state': 'NOT_A_MEMBER'
, co oznacza, że użytkownika nie ma już w pokoju.
{ "name": "spaces/SPACE/members/MEMBER", "state": "NOT_A_MEMBER" }
Powiązane artykuły
- Wyświetlanie szczegółowych informacji o subskrypcjach użytkownika lub aplikacji do obsługi czatu
- Wyświetlanie listy użytkowników w pokoju
- Zaproś do pokoju użytkownika lub aplikację do obsługi czatu albo dodaj do niego użytkownika