Gruppenbereiche löschen

In dieser Anleitung wird erläutert, wie Sie mit der Methode delete für die Ressource Space der Google Chat API einen benannten Gruppenbereich löschen, wenn er nicht mehr benötigt wird. Durch das Löschen eines Gruppenbereichs wird auch sein gesamter Inhalt gelöscht, einschließlich Nachrichten und Anhänge.

Voraussetzungen

Python

  • Python 3.6 oder höher
  • Das Paketverwaltungstool pip

  • Die neuesten 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-httplib2 google-auth-oauthlib oauth2client

  • Eine veröffentlichte Chat-App. Informationen zum Erstellen und Veröffentlichen einer Chat-App finden Sie unter Google Chat-App erstellen.

  • Für die Chat-Anwendung konfigurierte Autorisierung. Zum Löschen eines Gruppenbereichs ist eine Nutzerauthentifizierung mit dem Autorisierungsbereich chat.delete von einem Nutzer erforderlich, der die Berechtigung zum Löschen des angegebenen Bereichs hat.

Benannten Gruppenbereich löschen

Wenn Sie einen vorhandenen Gruppenbereich in Google Chat löschen möchten, übergeben Sie in Ihrer Anfrage Folgendes:

  • Geben Sie den Autorisierungsbereich chat.delete an.
  • Rufen Sie die Methode delete für die Ressource Space auf.
  • Übergeben Sie die name des zu löschenden Gruppenbereichs.

So löschen Sie einen Gruppenbereich:

Python

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

  2. Fügen Sie den folgenden Code in chat_space_delete.py ein:

    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.delete"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then deletes the specified space.
    '''

    # 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().delete(

          # The space 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.
          name='spaces/SPACE'

      ).execute()

    # Print Chat API's response in your command line interface.
    # When deleting a space, the response body is empty.
    print(result)

if __name__ == '__main__':
    main()

  3. Ersetzen Sie im Code SPACE durch den Namen des Gruppenbereichs. Diesen finden Sie in der Chat API mit der Methode spaces.list oder aus der URL eines Gruppenbereichs.

  4. Erstellen Sie das Beispiel in Ihrem Arbeitsverzeichnis und führen Sie es aus:

    python3 chat_space_delete.py

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer. Dies bedeutet, dass der Bereich gelöscht wurde.