Questa guida spiega come utilizzare
get()
sulla risorsa Message
dell'API Google Chat per restituire i dettagli su un
SMS o messaggio di una scheda.
Nell'API Chat, un messaggio di Chat è rappresentato dalla
risorsa Message
.
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 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 Node.js.
- Crea credenziali di accesso in base a come vuoi autenticarti nell'API Google Chat
richiesta:
- 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 account di servizio
credenziali 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 a seconda che tu voglia eseguire l'autenticazione come utente o come App Chat.
- Uno spazio di Google Chat in cui l'utente autenticato o app per le chiamate di Chat è 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 credenziali di accesso in base a come vuoi autenticarti nell'API Google Chat
richiesta:
- Per autenticarti come utente di Chat,
crea ID client OAuth
credenziali e salvale come file JSON denominato
client_secrets.json
alla 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 ID client OAuth
credenziali e salvale come file JSON denominato
- Scegli un ambito di autorizzazione a seconda che tu voglia eseguire l'autenticazione 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.
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 ID client OAuth
credenziali e salvale come file JSON denominato
client_secrets.json
alla tua directory locale. - Per autenticarti come app Chat,
crea account di servizio
credenziali e salvale come file JSON denominato
credentials.json
.
- Per autenticarti come utente di Chat,
crea ID client OAuth
credenziali e salvale come file JSON denominato
- Scegli un ambito di autorizzazione a seconda che tu voglia eseguire l'autenticazione come utente o come App Chat.
- Uno spazio di Google Chat in cui l'utente autenticato o app per le chiamate di Chat è membro. Per autenticarti come app Chat, aggiungi l'app Chat allo spazio.
Apps Script
- 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.
- Crea un progetto Apps Script autonomo e attiva il servizio Chat avanzato.
- In questa guida, devi utilizzare o autenticazione delle 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 a seconda che tu voglia eseguire l'autenticazione come utente o come App Chat.
- Uno spazio di Google Chat di cui l'utente autenticato o l'app Chat di chiamata è membro. Per autenticarsi come Chat, aggiungi Chat nello spazio.
Ricevere un messaggio con l'autenticazione utente
Per ottenere i dettagli di un messaggio con autenticazione utente, invia quanto segue nella richiesta:
- Specifica l'ambito di autorizzazione
chat.messages.readonly
ochat.messages
. - Chiama il metodo
GetMessage()
. - Imposta
name
sul nome della risorsa del messaggio da recuperare.
L'esempio seguente riceve un messaggio con autenticazione utente:
Node.js
Python
Java
Apps Script
Per eseguire questo sample, sostituisci quanto segue:
SPACE_NAME
: l'ID delname
dello spazio. Puoi ottenere l'ID chiamando il metodoListSpaces()
o dall'URL dello spazio.MESSAGE_NAME
: l'ID della colonnaname
Puoi ottenere l'ID dal corpo della risposta restituito dopo aver creato un i messaggi in modo asincrono con l'API Chat o con nome personalizzato e assegnato al messaggio al momento della creazione.
L'API Chat restituisce un'istanza
Message
che descrive in dettaglio il messaggio specificato.
Ricevere un messaggio con l'autenticazione dell'app
Per ottenere dettagli su un messaggio con autenticazione delle app, inserisci quanto segue nella tua richiesta:
- Specifica l'ambito di autorizzazione
chat.bot
. - Chiama il
GetMessage()
. - Imposta
name
sul nome della risorsa del messaggio da recuperare.
L'esempio seguente riceve un messaggio con autenticazione dell'app:
Node.js
Python
Java
Apps Script
Per eseguire questo esempio, sostituisci quanto segue:
SPACE_NAME
: l'ID della proprietàname
Puoi ottenerlo chiamando il metodoListSpaces()
o dall'URL dello spazio.MESSAGE_NAME
: l'ID diname
del messaggio. Puoi ottenere l'ID dal corpo della risposta restituito dopo aver creato un i messaggi in modo asincrono con l'API Chat o con nome personalizzato e assegnato al messaggio al momento della creazione.
L'API Chat restituisce un'istanza
Message
che descrive in dettaglio il messaggio specificato.
Argomenti correlati
- Formattare un messaggio.
- Eliminare un messaggio.
- Elenca i messaggi in uno spazio.
- Aggiorna un messaggio.
- Inviare un messaggio.