Questa guida spiega come utilizzare il metodo
list()
nella risorsa Message
dell'API Google Chat per visualizzare un elenco filtrabile e paginato dei messaggi in uno spazio.
Nell'API Chat, un messaggio di Chat è rappresentato dalla
Message
risorsa.
Sebbene gli utenti di Chat possano inviare solo messaggi contenenti testo,
le app di Chat possono utilizzare molte altre funzionalità di messaggistica, tra cui
la visualizzazione di interfacce utente statiche o interattive, la raccolta di informazioni da
gli utenti e l'invio di messaggi in privato. Per scoprire di più sulle funzionalità di messaggistica disponibili per l'API Chat, consulta la panoramica dei messaggi di Google Chat.
Prerequisiti
Node.js
- Un'azienda o un'impresa Google Workspace 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, l'icona e la descrizione dell'app Chat.
- Installa il Node.js libreria client di Cloud.
-
Creare le 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.
- Uno spazio di Google Chat. Per crearne uno utilizzando l'API Google Chat, consulta Creare uno spazio. Per crearne uno in Chat, consulta la documentazione del Centro assistenza.
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.
-
Creare le 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.
- Uno spazio di Google Chat. Per crearne uno utilizzando l'API Google Chat, consulta Creare uno spazio. Per crearne uno in Chat: visita il documentazione del Centro assistenza.
Java
- 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.
- Attiva e configura l'API Google Chat con un nome, un'icona e una descrizione per la tua app di chat.
- Installa il Java libreria client di Cloud.
-
Creare le credenziali con 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 degli utenti.
- Uno spazio di Google Chat. Per crearne uno utilizzando l'API Google Chat, consulta Creare uno spazio. Per crearne uno in Chat, consulta la documentazione del Centro assistenza.
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.
- Scegli un ambito di autorizzazione che supporti l'autenticazione utente.
- Uno spazio di Google Chat. Per crearne uno utilizzando l'API Google Chat, consulta Creare uno spazio. Per crearne uno in Chat: visita il documentazione del Centro assistenza.
Elenco di messaggi
Per elencare i messaggi con autenticazione utente, invia quanto segue nella richiesta:
- Specifica l'ambito dell'autorizzazione
chat.messages.readonly
ochat.messages
. - Chiama il
ListMessages()
.
Nell'esempio seguente sono elencati i messaggi in uno spazio di Chat:
Node.js
Python
Java
Apps Script
Per eseguire questo esempio, sostituisci SPACE_NAME
con l'ID del
campo
name
dello spazio. Puoi ottenerlo chiamando il metodo
ListSpaces()
o dall'URL dello spazio.
L'API Chat restituisce un
elenco di messaggi
inviati nello spazio specificato. Se la richiesta non contiene messaggi,
La risposta dell'API Chat restituisce un oggetto vuoto. Se utilizzi un protocollo REST/HTTP
a riga di comando, la risposta contiene un oggetto JSON vuoto, {}
.
Argomenti correlati
- Formattare un messaggio.
- Eliminare un messaggio.
- Visualizzare i dettagli di un messaggio.
- Aggiorna un messaggio.
- Inviare un messaggio.