In dieser Anleitung wird erläutert, wie Sie mit der Methode delete
für die Ressource membership
der Google Chat API einen Nutzer oder eine Chat-App aus einem Gruppenbereich entfernen. Dieser Vorgang wird auch als Löschen einer Mitgliedschaft bezeichnet. Administratoren eines Gruppenbereichs können nicht entfernt werden, wenn sie der einzige Administrator in einem Gruppenbereich sind. Legen Sie einen anderen Nutzer als Administrator des Gruppenbereichs fest, bevor Sie diese Mitgliedschaft entfernen.
Die Ressource Membership
gibt an, ob ein menschlicher Nutzer oder eine Google Chat-App in einen Gruppenbereich eingeladen oder dort teilweise eingeladen wurde oder nicht.
Voraussetzungen
Python
- Python 3.6 oder höher
- Das Paketverwaltungstool pip
Die aktuellen Google-Clientbibliotheken für Python. Führen Sie den folgenden Befehl in der Befehlszeile aus, um sie zu installieren oder zu aktualisieren:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Ein Google Cloud-Projekt, in dem die Google Chat API aktiviert und konfiguriert ist. Eine entsprechende Anleitung finden Sie unter Google Chat-App erstellen.
Für die Chat-App konfigurierte Autorisierung. Zum Löschen einer Mitgliedschaft ist eine Nutzerauthentifizierung mit dem Autorisierungsbereich
chat.memberships
oderchat.memberships.app
durch einen Nutzer erforderlich, der zum Löschen der angegebenen Mitgliedschaft berechtigt ist.
Nutzer oder Chat-Apps aus einem Gruppenbereich entfernen
So entfernen Sie einen Nutzer oder eine Chat-App aus einem Gruppenbereich:
- Wenn Sie einen Nutzer entfernen möchten, geben Sie den Autorisierungsbereich
chat.memberships
an. Wenn Sie eine Chat-App entfernen möchten, geben Sie den Autorisierungsbereichchat.memberships.app
an. Apps können nur ihre eigene Mitgliedschaft löschen, nicht die anderer Apps. Wählen Sie als Best Practice den restriktivsten Bereich aus, bei dem Ihre App noch funktionieren kann. - Rufen Sie die Methode
delete
für die Ressourcemembership
auf. - Übergeben Sie die
name
der zu löschenden Mitgliedschaft. Wenn die Mitgliedschaft dem einzigen Administrator des Gruppenbereichs in einem Gruppenbereich gehört, weisen Sie einen anderen Nutzer als Administrator des Gruppenbereichs zu, bevor Sie diese Mitgliedschaft löschen.
So löschst du eine Mitgliedschaft:
Python
- Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen
chat_membership_delete.py
. Fügen Sie den folgenden Code in
chat_membership_delete.py
ein: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()
Ersetzen Sie im Code Folgendes:
SPACE
: Der Name eines Gruppenbereichs, den Sie über die Methodespaces.list
in der Chat API oder aus der URL eines Gruppenbereichs abrufen können.MEMBER
: ein Mitgliedsname, den Sie über die Methodespaces.members.list
in der Chat API abrufen können. Wenn Sie die Mitgliedschaft einer App löschen möchten, ersetzen SieMEMBER
durchapp
.
Erstellen Sie das Beispiel in Ihrem Arbeitsverzeichnis und führen Sie es aus:
python3 chat_membership_delete.py
Wenn der Vorgang erfolgreich ist, gibt der Antworttext die Mitgliedschaft mit 'state': 'NOT_A_MEMBER'
zurück, was darauf hinweist, dass sich das Mitglied nicht mehr im Gruppenbereich befindet.
{ "name": "spaces/SPACE/members/MEMBER", "state": "NOT_A_MEMBER" }
Weitere Informationen
- Informationen zur Mitgliedschaft eines Nutzers oder einer Chat-App
- Listen Sie die Mitglieder in einem Gruppenbereich auf.
- Mitgliedschaft in einem Google Chat-Bereich aktualisieren
- Nutzer oder Chat-App in einen Gruppenbereich einladen oder hinzufügen