Questa guida spiega come utilizzare il metodo
get()
su una risorsa Space
dell'API Google Chat per visualizzare i dettagli di uno spazio, come il nome visualizzato, la descrizione e le linee guida.
Se sei un amministratore di Google Workspace, puoi chiamare il metodo get()
per recuperare i dettagli di qualsiasi spazio nella tua organizzazione Google Workspace.
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.
L'autenticazione con autenticazione app consente a un'app di Chat di ottenere i dettagli di uno spazio di cui l'app di Chat è membro. L'autenticazione con autenticazione utente ti consente di accedere agli spazi a cui l'utente autenticato ha accesso, come membro dello spazio o come amministratore di Google Workspace.
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 di accesso in base alla modalità di autenticazione nella richiesta dell'API Google Chat:
- Per autenticarti come utente di Chat,
crea le credenziali dell'ID client OAuth e salvale come file JSON nominato
client_secrets.json
nella tua directory locale. - Per autenticarti come app Chat,
crea le credenziali dell'account di servizio e salvale come file JSON denominato
credentials.json
.
- Per autenticarti come utente di Chat,
crea le credenziali dell'ID client OAuth e salvale come file JSON nominato
- Scegli un ambito di autorizzazione in base a se vuoi autenticarti come utente o come app Chat.
- Uno spazio Google Chat di cui l'utente autenticato o l'app Chat chiamante è membro. Per autenticarti come app Chat, aggiungi l'app Chat allo spazio.
Python
- 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 Python.
- Crea le credenziali di accesso in base alla modalità di autenticazione nella richiesta dell'API Google Chat:
- Per autenticarti come utente di Chat,
crea le credenziali dell'ID client OAuth e salvale come file JSON nominato
client_secrets.json
nella tua directory locale. - Per autenticarti come app Chat,
crea le credenziali dell'account di servizio e salvale come file JSON denominato
credentials.json
.
- Per autenticarti come utente di Chat,
crea le credenziali dell'ID client OAuth e salvale come file JSON nominato
- Scegli un ambito di autorizzazione in base a se vuoi autenticarti come utente o come app Chat.
- Uno spazio Google Chat di cui l'utente autenticato o l'app Chat chiamante è membro. Per autenticarti come app Chat, aggiungi l'app Chat allo spazio.
Java
- 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 Java.
- Crea le credenziali di accesso in base alla modalità di autenticazione nella richiesta dell'API Google Chat:
- Per autenticarti come utente di Chat,
crea le credenziali dell'ID client OAuth e salvale come file JSON nominato
client_secrets.json
nella tua directory locale. - Per autenticarti come app Chat,
crea le credenziali dell'account di servizio e salvale come file JSON denominato
credentials.json
.
- Per autenticarti come utente di Chat,
crea le credenziali dell'ID client OAuth e salvale come file JSON nominato
- Scegli un ambito di autorizzazione in base a se vuoi autenticarti come utente o come app Chat.
- Uno spazio di Google Chat di cui l'utente autenticato o l'app Chat di chiamata è membro. Per autenticarti come app Chat, aggiungi l'app Chat allo spazio.
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.
- Attiva e configura l'API Google Chat con un nome, un'icona e una descrizione per la tua app di chat.
- Crea un progetto Apps Script autonomo e attiva il servizio Chat avanzato.
- In questa guida devi utilizzare l'autenticazione dell'utente o dell'app. Per autenticarti come app Chat, crea le credenziali dell'account di servizio. Per la procedura, consulta Autenticare e autorizzare come app Google Chat.
- Scegli un ambito di autorizzazione in base a se vuoi autenticarti come utente o come app Chat.
- Uno spazio Google Chat di cui l'utente autenticato o l'app Chat chiamante è membro. Per autenticarti come app Chat, aggiungi l'app Chat allo spazio.
Crea uno spazio
Per ottenere uno spazio in Google Chat, specifica quanto segue nella richiesta:
- Un ambito di autorizzazione:
- Con
l'autenticazione utente,
specifica l'ambito di autorizzazione
chat.spaces.readonly
ochat.spaces
. - Con l'autenticazione app,
specifica l'ambito di autorizzazione
chat.bot
o l'ambitochat.app.spaces
. L'ambitochat.app.spaces
è disponibile in Anteprima per sviluppatori e richiede un'approvazione dell'amministratore una tantum.
- Con
l'autenticazione utente,
specifica l'ambito di autorizzazione
- Chiama il metodo
GetSpace()
passando ilname
dello spazio da recuperare. Ottieni il nome dello spazio dalla risorsaSpace
di Google Chat o dall'URL di uno spazio.
Visualizzare i dettagli di uno spazio come utente
Ecco come ottenere i dettagli dello spazio con l'autenticazione utente:
Node.js
Python
Java
Apps Script
Per eseguire questo esempio, sostituisci SPACE_NAME
con l'ID del
campo
name
dello spazio. Puoi ottenere l'ID chiamando il metodo
ListSpaces()
o dall'URL dello spazio.
L'API Chat restituisce un'istanza di
Space
che descrive lo spazio specificato.
Visualizzare i dettagli dello spazio come amministratore di Google Workspace
Se sei un amministratore di Google Workspace, puoi chiamare il metodo GetSpace
per recuperare i dettagli di qualsiasi spazio nella tua organizzazione Google Workspace.
Per chiamare questo metodo in qualità di amministratore di Google Workspace:
- Chiama il metodo utilizzando l'autenticazione utente e specifica un ambito di autorizzazione che supporti la chiamata del metodo utilizzando privilegi di amministratore.
- Nella richiesta, specifica il parametro di query
useAdminAccess
pertrue
.
Per ulteriori informazioni ed esempi, vedi Gestire gli spazi di Google Chat come amministratore di Google Workspace.
Visualizzare i dettagli dello spazio come app Chat
Ecco come ottenere i dettagli dello spazio con l'autenticazione dell'app:
Node.js
Python
Java
Apps Script
Per eseguire questo esempio, sostituisci SPACE_NAME
con l'ID del
campo
name
dello spazio. Puoi ottenere l'ID chiamando il metodo
ListSpaces()
o dall'URL dello spazio.
L'API Chat restituisce un'istanza di
Space
che descrive lo spazio specificato.
Argomenti correlati
- Crea uno spazio.
- Configura uno spazio.
- Elenca gli spazi.
- Aggiorna uno spazio.
- Eliminare uno spazio.
- Trova uno spazio di messaggi diretti.