Questa guida spiega come utilizzare il metodo
setUp()
nella risorsa Space
dell'API Google Chat per configurare uno spazio Google Chat. La configurazione di uno spazio crea uno spazio e aggiunge gli utenti specificati.
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 tra 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.
Quando configuri uno spazio, tieni presente quanto segue:
- L'utente chiamante (autenticato) viene aggiunto automaticamente allo spazio, quindi non è necessario specificare l'appartenenza dell'utente nella richiesta.
- Quando crei un messaggio diretto, se esiste un messaggio diretto tra due utenti, viene restituito il messaggio diretto. In caso contrario, viene creato un messaggio diretto.
- Quando crei una chat di gruppo, se nessuno dei membri specificati nella richiesta viene aggiunto alla chat di gruppo (ad esempio, a causa di un problema di autorizzazione), potrebbe essere creata una chat di gruppo vuota (che include solo l'utente che effettua la chiamata).
- Non puoi configurare spazi con risposte in thread o aggiungere persone esterne a Google Workspace.
- Gli abbonamenti duplicati (incluso l'utente che effettua la chiamata) forniti nella richiesta vengono filtrati anziché generare un errore di richiesta.
Prerequisiti
Node.js
- Un account Google Workspace Business o Enterprise con accesso a Google Chat.
- Configura l'ambiente:
- Crea un progetto Google Cloud.
- Configura la schermata per il consenso OAuth.
- Attiva e configura l'API Google Chat con un nome, un'icona e una descrizione per la tua app di chat.
- Installa la libreria client Cloud per Node.js.
-
Crea le credenziali dell'ID client OAuth per un'applicazione desktop. Per eseguire l'esempio in questa
guida, salva le credenziali come file JSON denominato
client_secrets.json
nella directory locale.
- Scegli un ambito di autorizzazione che supporti l'autenticazione utente.
Python
- Un account Google Workspace Business o Enterprise con accesso a Google Chat.
- Configura l'ambiente:
- Creare un progetto Google Cloud.
- Configura la schermata per il consenso OAuth.
- Attiva e configura l'API Google Chat con un nome, un'icona e una descrizione per la tua app di chat.
- Installa la libreria client Cloud per Python.
-
Crea le credenziali dell'ID client OAuth per un'applicazione desktop. Per eseguire l'esempio in questa guida, salva le credenziali come file JSON denominato
client_secrets.json
nella tua directory locale.
- Scegli un ambito di autorizzazione che supporti l'autenticazione utente.
Java
- Un account Google Workspace Business o Enterprise 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, un'icona e una descrizione per l'app Chat.
- Installa la libreria client di Cloud Java.
-
Crea le credenziali dell'ID client OAuth per un'applicazione desktop. Per eseguire l'esempio in questa
guida, salva le credenziali come file JSON denominato
client_secrets.json
nella directory locale.
- Scegli un ambito di autorizzazione che supporti l'autenticazione utente.
Apps Script
- Un account Google Workspace Business o Enterprise con accesso a Google Chat.
- Configura l'ambiente:
- Crea un progetto Google Cloud.
- Configura la schermata per il consenso OAuth.
- Abilita e configura l'API Google Chat con un nome, un'icona e una descrizione per l'app Chat.
- Crea un progetto Apps Script autonomo e attiva il servizio di chat avanzato.
- Scegli un ambito di autorizzazione che supporti l'autenticazione utente.
Configura uno spazio
Per configurare uno spazio, specifica quanto segue nella richiesta:
- Specifica l'ambito di autorizzazione
chat.spaces.create
ochat.spaces
. - Chiama il metodo
SetUpSpace()
. - Passa
space
come istanza diSpace
con tutti i campi necessari, ad esempiodisplayName
ospaceType
. - Passa
memberships
come array diMembership
istanze. Per ogni istanza:- Specifica
users/{user}
per aggiungere un utente umano come membro dello spazio, dove{user}
è il{person_id}
perperson
dell'API People o l'ID diuser
nell'API Directory. Ad esempio, se la persona dell'API PeopleresourceName
èpeople/123456789
, puoi aggiungere l'utente allo spazio includendo un abbonamento conusers/123456789
comemember.name
. - Specifica
groups/{group}
per aggiungere un gruppo come membro di uno spazio, dove{group}
è l'ID gruppo per cui vuoi creare l'abbonamento. L'ID del gruppo puoi essere recuperato utilizzando l'API Cloud Identity. Ad esempio, se l'API Cloud Identity restituisce un gruppo con il nomegroups/123456789
, impostamembership.groupMember.name
sugroups/123456789
. I gruppi Google non possono essere aggiunti a una chat di gruppo o a un messaggio diretto, ma solo a uno spazio denominato.
- Specifica
Per creare un messaggio diretto tra l'utente che chiama e un altro utente, specifica l'appartenenza dell'utente nella richiesta.
Per creare un messaggio diretto tra l'utente che effettua la chiamata e l'app di chiamata, imposta
space.singleUserBotDm
su true
e non specificare alcun gruppo di appartenenza. Puoi
utilizzare questo metodo solo per configurare un messaggio diretto con l'app di chiamata. Per aggiungere l'app di chiamata come membro di uno spazio o di un messaggio diretto esistente tra due utenti umani, consulta
Creare un abbonamento.
L'esempio seguente crea uno spazio denominato e un'appartenenza allo spazio per due utenti umani (l'utente autenticato e un altro utente).
Node.js
Python
Java
Apps Script
Per eseguire l'esempio, sostituisci quanto segue:
DISPLAY_NAME
: il nome visualizzato del nuovo spazio.USER_NAME
: l'ID dell'altro utente per cui includere un abbonamento.
Per accedere allo spazio, utilizza l'ID risorsa dello spazio per creare l'URL dello spazio.
Puoi ottenere l'ID risorsa dallo spazio name
nel corpo della risposta di Google Chat. Ad esempio, se il valore 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
- Crea uno spazio.
- Visualizzare i dettagli di uno spazio.
- Elenca gli spazi.
- Aggiorna uno spazio.
- Eliminare uno spazio.
- Trova uno spazio di messaggi diretti.
- Rendi uno spazio rilevabile per utenti specifici.