In dieser Anleitung wird erläutert, wie Sie mit der Methode delete
für die Ressource Space
der Google Chat API einen benannten Bereich löschen, wenn er nicht mehr benötigt wird. Dabei werden auch alle darin enthaltenen Nachrichten und Anhänge gelöscht.
Die Ressource Space
stellt einen Ort dar, an dem Nutzer und Chat-Apps Nachrichten senden, Dateien freigeben und zusammenarbeiten können. Es gibt verschiedene Arten von Gruppenbereichen:
- Direktnachrichten (DMs) sind Unterhaltungen zwischen zwei Nutzern oder einem Nutzer und einer Chat-App.
- Gruppenchats sind Unterhaltungen zwischen drei oder mehr Nutzern und Chat-Apps.
- Benannte Gruppenbereiche sind persistente Orte, an denen Nutzer Nachrichten senden, Dateien freigeben und zusammenarbeiten.
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 eines Gruppenbereichs ist eine Nutzerauthentifizierung mit dem Autorisierungsbereich
chat.delete
erforderlich. Die Authentifizierung muss dabei von einem Nutzer erfolgen, der die Berechtigung zum Löschen des angegebenen Bereichs hat.
Node.js
- Node.js und npm
Aktuelle Google-Clientbibliotheken für Node.js Führen Sie den folgenden Befehl über die Befehlszeile aus, um sie zu installieren:
npm install @google-cloud/local-auth @googleapis/chat
- 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 eines Gruppenbereichs ist eine Nutzerauthentifizierung mit dem Autorisierungsbereich
chat.delete
erforderlich. Die Authentifizierung muss dabei von einem Nutzer erfolgen, 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 RessourceSpace
auf. - Übergeben Sie den
name
des zu löschenden Gruppenbereichs.
So löschen Sie einen Gruppenbereich:
Python
- Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen
chat_space_delete.py
. Fügen Sie den folgenden Code in
chat_space_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.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()
Ersetzen Sie im Code
SPACE
durch den Namen des Gruppenbereichs, den Sie in der Chat API mit der Methodespaces.list
oder aus der URL eines Gruppenbereichs abrufen können.Erstellen Sie das Beispiel in Ihrem Arbeitsverzeichnis und führen Sie es aus:
python3 chat_space_delete.py
Node.js
- Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen
delete-space.js
. Fügen Sie den folgenden Code in
delete-space.js
ein:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Deletes a Chat space. * @return {!Promise<!Object>} */ async function deleteSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.delete', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.delete({name: 'spaces/SPACE'}); } deleteSpace().then(console.log);
Ersetzen Sie im Code
SPACE
durch den Namen eines Gruppenbereichs, den Sie mit der Methodespaces.list
in der Chat API oder aus der URL eines Gruppenbereichs abrufen können.Führen Sie das Beispiel in Ihrem Arbeitsverzeichnis aus:
node delete-space.js
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer. Das bedeutet, dass der Bereich gelöscht wurde.
Weitere Informationen
- Gruppenbereich erstellen
- Details zu einem Gruppenbereich abrufen
- Gruppenbereiche auflisten.
- Gruppenbereiche aktualisieren
- Gruppenbereiche löschen
- Richten Sie einen Gruppenbereich ein.
- Suchen Sie einen Gruppenbereich für Direktnachrichten.