Questa guida spiega come utilizzare il metodo create
nella risorsa Space
di
l'API Google Chat per creare uno spazio denominato.
La
Space
risorsa
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 collaborare.
Uno spazio denominato è un luogo in cui le persone inviano messaggi, condividono file
e collaborare. Gli spazi denominati possono includere app di chat. Spazi denominati
Includono funzionalità aggiuntive che consentono di indirizzare i messaggi e le conversazioni di gruppo senza nome
non disponibili, ad esempio 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
Includono altre persone o app; nemmeno l'app Chat
che li crea. Per aggiungere persone, crea iscrizioni nello spazio chiamando il
Metodo create
il
Member
risorsa.
Per scoprire come fare, vedi Creare un abbonamento.
Per creare uno spazio denominato con più membri, ovvero una chat di gruppo senza nome tra da tre o più persone oppure da una conversazione con messaggi diretti tra due persone oppure e l'app Chat che chiama API Chat: configura uno spazio .
Prerequisiti
Python
- Un'azienda o un'impresa Google Workspace con accesso a Google Chat.
- Configura l'ambiente:
- Creare un progetto Google Cloud.
- Configura la schermata per il consenso OAuth.
- Abilita e configura l'API Google Chat con un nome, l'icona e la descrizione dell'app Chat.
- Installa il Python Libreria client delle API di Google.
-
Creare credenziali con ID client OAuth per un'applicazione desktop. Per eseguire l'esempio in questo
guida, salva le credenziali come file JSON denominato
client_secrets.json
nel tuo nella directory locale.
- Scegli un ambito di autorizzazione che supporti l'autenticazione degli utenti.
Node.js
- Un'azienda o un'impresa Google Workspace con accesso a Google Chat.
- Configura l'ambiente:
- Creare un progetto Google Cloud.
- Configura la schermata per il consenso OAuth.
- Abilita e configura l'API Google Chat con un nome, l'icona e la descrizione dell'app Chat.
- Installa il Node.js Libreria client delle API di Google.
-
Creare credenziali con ID client OAuth per un'applicazione desktop. Per eseguire l'esempio in questo
guida, salva le credenziali come file JSON denominato
client_secrets.json
nel tuo nella directory locale.
- Scegli un ambito di autorizzazione che supporti l'autenticazione degli utenti.
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
ilSpace
risorsa. - Imposta
spaceType
aSPACE
. - Imposta
displayName
al nome dello spazio visibile dall'utente. Nell'esempio seguente,displayName
è impostato suAPI-made
. - Se vuoi, puoi impostare altri attributi dello spazio, come
spaceDetails
(una descrizione visibile all'utente e una serie 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, utilizza l'ID risorsa dello spazio
per creare l'URL dello spazio. Puoi trovare l'ID risorsa nello spazio
name
nel corpo della risposta di Google Chat. Ad esempio, se il tuo spazio
name
è spaces/1234567
, puoi accedere allo spazio utilizzando:
URL: https://mail.google.com/chat/u/0/#chat/space/1234567
.
Argomenti correlati
- Aggiungi persone e app allo spazio tramite creazione di membri.
- Pubblica un messaggio nello spazio di creazione di 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.