Questa guida spiega come utilizzare il metodo delete
nella risorsa Space
dell'API Google Chat per eliminare uno spazio denominato quando non è più necessario. L'eliminazione di uno spazio elimina anche tutto il suo contenuto, inclusi i messaggi e gli allegati.
La risorsa Space
rappresenta un luogo in cui le persone e le app di Chat possono inviare messaggi, condividere file e collaborare. Esistono diversi tipi di spazi:
- I messaggi diretti sono conversazioni tra due utenti o un utente e un'app di Chat.
- Le chat di gruppo sono conversazioni tra tre o più utenti e app di Chat.
- Gli spazi con nome sono luoghi permanenti in cui le persone inviano messaggi, condividono file e collaborano.
Prerequisiti
Python
- Python 3.6 o versioni successive
- Lo strumento di gestione dei pacchetti pip
Le librerie client di Google più recenti per Python. Per installarli o aggiornarli, esegui questo comando nell'interfaccia a riga di comando:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Un progetto Google Cloud con l'API Google Chat abilitata e configurata. Per i passaggi da seguire, vedi Creare un'app Google Chat.
Autorizzazione configurata per l'app Chat. L'eliminazione di uno spazio richiede l'autenticazione dell'utente con l'ambito di autorizzazione
chat.delete
da parte di un utente che dispone dell'autorizzazione per eliminare lo spazio specificato.
Node.js
- Node.js e npm
Le librerie client di Google più recenti per Node.js. Per installarle, esegui questo comando nell'interfaccia a riga di comando:
npm install @google-cloud/local-auth @googleapis/chat
- Un progetto Google Cloud con l'API Google Chat abilitata e configurata. Per i passaggi da seguire, vedi Creare un'app Google Chat.
Autorizzazione configurata per l'app Chat. L'eliminazione di uno spazio richiede l'autenticazione dell'utente con l'ambito di autorizzazione
chat.delete
da parte di un utente che dispone dell'autorizzazione per eliminare lo spazio specificato.
Eliminare uno spazio denominato
Per eliminare uno spazio esistente in Google Chat, trasmetti quanto segue nella richiesta:
- Specifica l'ambito dell'autorizzazione
chat.delete
. - Chiama il metodo
delete
sulla risorsaSpace
. - Supera
name
dello spazio da eliminare.
Ecco come eliminare uno spazio:
Python
- Nella directory di lavoro, crea un file denominato
chat_space_delete.py
. Includi il seguente codice in
chat_space_delete.py
: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()
Nel codice, sostituisci
SPACE
con il nome dello spazio, che puoi ottenere dal metodospaces.list
nell'API Chat o dall'URL di uno spazio.Nella directory di lavoro, crea ed esegui l'esempio:
python3 chat_space_delete.py
Node.js
- Nella directory di lavoro, crea un file denominato
delete-space.js
. Includi il seguente codice in
delete-space.js
: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);
Nel codice, sostituisci
SPACE
con il nome di uno spazio, che puoi ottenere dal metodospaces.list
nell'API Chat o dall'URL di uno spazio.Nella directory di lavoro, esegui l'esempio:
node delete-space.js
In caso di esito positivo, il corpo della risposta è vuoto, a indicare che lo spazio è stato eliminato.
Argomenti correlati
- Creare uno spazio
- Ottenere dettagli su uno spazio.
- Elenca spazi.
- Aggiornare uno spazio.
- Eliminare uno spazio.
- Configura uno spazio.
- Trova uno spazio per i messaggi diretti.