Ein Mitglied aus einem Gruppenbereich entfernen

In diesem Leitfaden wird erläutert, wie Sie die Methode delete für die Ressource membership verwenden. der Google Chat API verwenden, um ein Mitglied aus einem Gruppenbereich zu entfernen. Dies wird auch als Löschen eines Mitgliedschaft. Administratoren von Gruppenbereichen können nicht entfernt werden, wenn sie der einzige Administrator des Gruppenbereichs sind in einem Gruppenbereich. Legen Sie einen anderen Nutzer als Administrator des Gruppenbereichs fest, bevor Sie diese Nutzer entfernen Kanalmitgliedschaft.

Die Membership-Ressource gibt an, ob ein menschlicher Nutzer oder die Google Chat App Teil eines Leerzeichens oder fehlt.

Vorbereitung

Python

  • Python 3.6 oder höher
  • Das pip-Element Paketverwaltungstool

  • Die neuesten Google-Clientbibliotheken für Python. So installieren oder aktualisieren Sie sie: Führen Sie in der Befehlszeile den folgenden Befehl aus:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • Ein Google Cloud-Projekt mit aktivierter und konfigurierter Google Chat API. Eine Anleitung dazu finden Sie unter Erstellen Sie eine Google Chat App.

  • Für die Chat App konfigurierte Autorisierung Wird gelöscht eine Mitgliedschaft erfordert Nutzerauthentifizierung mit dem chat.memberships- oder chat.memberships.app-Autorisierungsbereich eines Nutzers , der zum Löschen der angegebenen Mitgliedschaft berechtigt ist.

Ein Mitglied aus einem Gruppenbereich entfernen

So entfernen Sie einen Nutzer, eine Google Groups-App oder eine Chat-App aus einem Gruppenbereich:

  • Geben Sie die chat.memberships-Autorisierung an, um einen Nutzer oder eine Google-Gruppe zu entfernen Umfang. Wenn Sie eine Chat-App entfernen möchten, geben Sie die Methode chat.memberships.app-Autorisierungsbereich (Apps können nur ihren eigenen löschen) Mitgliedschaft; und nicht die anderer Apps). Wählen Sie als Best Practice eingeschränkt, durch die Ihre App weiterhin funktioniert.
  • Rufen Sie die Methode delete auf. am membership-Ressource.
  • Übergib die name der zu löschenden Mitgliedschaft. Wenn die Mitgliedschaft zum Nur Administrator des Gruppenbereichs in einem Gruppenbereich; weisen Sie zuerst einen anderen Nutzer als Administrator des Gruppenbereichs zu Löschen dieser Mitgliedschaft

So löschst du eine Mitgliedschaft:

Python

  1. Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen chat_membership_delete.py.

  2. 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()

  3. Ersetzen Sie im Code Folgendes:

    • SPACE: ein Name für den Gruppenbereich, den Sie über die Methode spaces.list in der Chat API oder über die URL eines Gruppenbereichs.

    • MEMBER: ein Name der Mitgliedschaft, den Sie abrufen können mit der Methode spaces.members.list in der Chat API. Um die Mitgliedschaft einer App zu löschen, ersetzen Sie MEMBER mit app.

  4. 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': Das Mitglied ist nicht mehr im Gruppenbereich.

{
    "name": "spaces/SPACE/members/MEMBER",
    "state": "NOT_A_MEMBER"
}