Z tego przewodnika dowiesz się, jak używać metody delete
w zasobie membership
interfejsu Google Chat API do usunięcia użytkownika z pokoju, znanego też jako usunięcie subskrypcji. Nie można usunąć menedżerów pokoju,
jeśli są jedynym menedżerem pokoju. Zanim usuniesz członków, przypisz innego użytkownika jako menedżera pokoju.
Zasób Membership
informuje o tym, czy użytkownik lub aplikacja Google Chat został zaproszony do pokoju, jego część lub brak w nim.
Wymagania wstępne
Python
- Python w wersji 3.6 lub nowszej
- Narzędzie do zarządzania pakietami pip
Najnowsze biblioteki klienta Google dla języka Python. Aby je zainstalować lub zaktualizować, uruchom to polecenie w interfejsie wiersza poleceń:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Projekt Google Cloud z włączonym i skonfigurowanym interfejsem Google Chat API. Instrukcje znajdziesz w artykule Tworzenie aplikacji w Google Chat.
Autoryzacja skonfigurowana dla aplikacji Google Chat. Usuwanie subskrypcji wymaga uwierzytelniania użytkownika z zakresem autoryzacji
chat.memberships
lubchat.memberships.app
od użytkownika, który ma uprawnienia do usunięcia określonej subskrypcji.
Usuwanie osoby z pokoju
Aby usunąć z pokoju użytkownika, Grupę dyskusyjną Google lub aplikację Google Chat:
- Aby usunąć użytkownika lub grupę dyskusyjną Google, 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 subskrypcje – nie uprawnienia innych aplikacji). Zalecamy wybranie tak rygorystycznego zakresu, aby aplikacja nadal mogła działać. - Wywołaj metodę
delete
w zasobiemembership
. - Aby usunąć subskrypcję, przekaż
name
subskrypcji. Jeśli członkostwo należy do jedynego menedżera pokoju w pokoju, zanim usuniesz tę osobę, przypisz innego użytkownika jako menedżera pokoju.
Aby usunąć subskrypcję:
Python
- W katalogu roboczym utwórz plik o nazwie
chat_membership_delete.py
. Umieść w pliku
chat_membership_delete.py
ten kod: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()
Zastąp w kodzie następujące elementy:
SPACE
: nazwa pokoju, którą można uzyskać za pomocą metodyspaces.list
w interfejsie Chat API lub z adresu URL pokoju.MEMBER
: nazwa członkostwa, którą można uzyskać za pomocą metodyspaces.members.list
w interfejsie Chat API. Aby usunąć subskrypcję aplikacji, zamieńMEMBER
naapp
.
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
- Uzyskiwanie informacji o subskrypcji użytkownika lub w aplikacji Google Chat
- Wyświetlanie listy użytkowników w pokoju
- Aktualizowanie subskrypcji użytkownika w pokoju Google Chat
- Zapraszanie i dodawanie użytkowników lub aplikacji Google Chat do pokoju oraz dodawanie ich do pokoju