Questa guida spiega come utilizzare il metodo create
nella risorsa Space
dell'API Google Chat per creare uno spazio denominato.
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.
Uno spazio denominato è un luogo in cui le persone inviano messaggi, condividono file e
collaborano. Gli spazi denominati possono includere app di chat. Gli spazi con nome
includono funzionalità aggiuntive di cui non sono disponibili le conversazioni di gruppo e i messaggi diretti
senza nome, ad esempio i gestori dello spazio che possono applicare impostazioni amministrative,
descrizioni e aggiungere o rimuovere persone e app. Dopo aver creato uno spazio denominato,
l'unico membro dello spazio è l'utente autenticato. Lo spazio non
include altre persone o app, nemmeno l'app Chat
che lo crea. Per aggiungere persone, crea appartenenze nello spazio chiamando il
metodo create
nella
risorsa Member
.
Per scoprire come fare, vedi Creare un abbonamento.
Per creare uno spazio denominato con più membri, ad esempio una chat di gruppo senza nome tra tre o più persone o una conversazione con messaggi diretti tra due persone o una persona con l'app Chat che chiama l'API Chat, configura uno spazio.
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. La creazione di uno spazio richiede l'autenticazione dell'utente con l'ambito di autorizzazione
chat.spaces.create
ochat.spaces
.
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. La creazione di uno spazio richiede l'autenticazione dell'utente con l'ambito di autorizzazione
chat.spaces.create
ochat.spaces
.
Crea uno spazio denominato
Per creare uno spazio denominato, trasmetti quanto segue nella richiesta:
- Specifica l'ambito dell'autorizzazione
chat.spaces.create
ochat.spaces
. - Chiama il metodo
create
sulla risorsaSpace
. - Imposta
spaceType
suSPACE
. - Imposta
displayName
sul nome visibile all'utente dello spazio. Nell'esempio seguente,displayName
è impostato suAPI-made
. - Se vuoi, imposta altri attributi dello spazio, come
spaceDetails
(una descrizione visibile all'utente e un insieme di linee guida per lo spazio).
Ecco come creare uno spazio denominato:
Python
- Nella directory di lavoro, crea un file denominato
chat_space_create_named.py
. Includi il seguente codice in
chat_space_create_named.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.spaces.create"] def main(): ''' Authenticates with Chat API via user credentials, then creates a Chat 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().create( # Details about the space to create. body = { # To create a named space, set spaceType to SPACE. 'spaceType': 'SPACE', # The user-visible name of the space. 'displayName': 'API-made' } ).execute() # Prints details about the created space. print(result) if __name__ == '__main__': main()
Nella directory di lavoro, crea ed esegui l'esempio:
python3 chat_space_create_named.py
Node.js
- Nella directory di lavoro, crea un file denominato
create-space.js
. Includi il seguente codice in
create-space.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Creates a new chat space. * @return {!Promise<!Object>} */ async function createSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.spaces.create', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.create( {requestBody: {spaceType: 'SPACE', displayName: 'API-made'}}); } createSpace().then(console.log);
Nella directory di lavoro, esegui l'esempio:
node create-space.js
Viene creato uno spazio denominato. Per accedere allo spazio, usa l'ID risorsa dello spazio per creare l'URL dello spazio. Puoi trovare l'ID risorsa dello spazio name
nel corpo della risposta di Google Chat. Ad esempio, se il name
del tuo spazio è spaces/1234567
, puoi accedere allo spazio utilizzando il seguente URL: https://mail.google.com/chat/u/0/#chat/space/1234567
.
Argomenti correlati
- Aggiungi persone e app allo spazio creando membri.
- Pubblica un messaggio nello spazio creando un messaggio.
- Ottenere dettagli su uno spazio.
- Elenca spazi.
- Aggiornare uno spazio.
- Eliminare uno spazio.
- Configura uno spazio.
- Trova uno spazio per i messaggi diretti.
- Rendere uno spazio rilevabile per utenti specifici.