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
- Python 3.6 o versioni successive
- Il pip strumento di gestione dei pacchetti
Le librerie client di Google più recenti per Python. Per installare o aggiornare 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, vedi Crea un'app Google Chat.
Autorizzazione configurata per l'app Chat. Creazione in corso... uno spazio richiede L'autenticazione degli utenti con Ambito dell'autorizzazione
chat.spaces.create
ochat.spaces
.
Node.js
- Node.js e
Le librerie client di Google più recenti per Node.js. Per installarle, esegui il seguente 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, vedi Crea un'app Google Chat.
Autorizzazione configurata per l'app Chat. Creazione in corso... uno spazio richiede L'autenticazione degli utenti con Ambito dell'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
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.