Questa sezione spiega come un'app Google Chat può chiamare l'API Chat, che consente alle app di Chat di eseguire operazioni come creare uno spazio, aggiungere persone e pubblicare un messaggio.
Autenticazione
La chiamata all'API Chat richiede l'autenticazione. Ogni metodo dell'API Chat richiede autenticazione utente (per eseguire azioni o accedere ai dati per conto di un utente) o autenticazione dell'app (per eseguire azioni o accedere ai dati come app di Chat). Alcuni metodi supportano sia l'autenticazione utente sia l'autenticazione dell'app.
Per scoprire di più sull'autenticazione in Chat, consulta la Panoramica dell'autenticazione.
Librerie client
Il modo consigliato per la maggior parte degli sviluppatori per chiamare l'API Google Chat è tramite le nostre librerie client Cloud supportate ufficialmente per il linguaggio che preferisci, ad esempio Python, Java o Node.js.
Se scrivi codice con Google Apps Script, utilizza il servizio Chat avanzato instead of installing a client library.
Concetti dell'API Google Chat
Servizi gRPC o risorse e metodi REST concedono l'accesso a spazi di Chat, membri dello spazio, messaggi, reazioni ai messaggi, allegati dei messaggi, eventi dello spazio e stati di lettura degli utenti.
- Spazi
Gli spazi sono luoghi in cui persone e app possono conversare e condividere file. Esistono diversi tipi di spazi. I messaggi diretti sono conversazioni 1:1 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.
Riferimento alla risorsa:
Per esempi di utilizzo, consulta:
- Membri
I membri sono gli utenti e le app di Chat che hanno aderito a uno spazio o sono invitati.
Riferimento alla risorsa:
Per esempi di utilizzo, consulta:
- Messaggi
I messaggi includono comunicazioni con testo e schede pubblicate negli spazi. I messaggi possono avere file allegati. Le persone possono reagire ai messaggi aggiungendo emoji.
Riferimento alla risorsa:
Per esempi di utilizzo, consulta:
- Reazioni
Le Reazioni rappresentano le emoji che le persone usano per reagire a un messaggio, ad esempio 👍, 🚲 e 🌞.
Riferimento alla risorsa:
Per esempi di utilizzo, consulta:
- Emoji personalizzate (anteprima per sviluppatori)
Le emoji personalizzate rappresentano le emoji personalizzate create e condivise all'interno dell'organizzazione in Google Chat. Le emoji personalizzate possono essere incluse nei contenuti di un messaggio o utilizzate per reagire a un messaggio.
Riferimento alla risorsa:
- Contenuti multimediali e allegati
Contenuti multimediali indica un file caricato su Google Chat, ad esempio immagini, video e documenti.
Riferimento alla risorsa multimediale (non disponibile in RPC):
Gli allegati sono istanze di contenuti multimediali (file) allegati ai messaggi.
Riferimento alla risorsa:
Per esempi di utilizzo, consulta:
- Eventi di Space
Gli eventi dello spazio rappresentano le modifiche apportate a uno spazio o alle sue risorse secondarie, inclusi i membri, i messaggi e le reazioni.
Riferimento alla risorsa:
Per esempi di utilizzo, consulta:
- Stati di lettura dell'utente
Gli stati di lettura dell'utente sono risorse singleton che rappresentano i dettagli dell'ultimo messaggio letto da un utente specificato in uno spazio di Google Chat o in un thread di messaggi.
Riferimento alla risorsa dello stato di lettura dello spazio:
Riferimento alla risorsa dello stato di lettura del thread:
Per esempi di utilizzo, consulta:
- Impostazioni di notifica dello spazio utente (anteprima per sviluppatori)
Le impostazioni di notifica dello spazio utente sono risorse singleton che rappresentano impostazioni di notifica dell'utente specificate in uno spazio di Google Chat.
Riferimento alla risorsa:
Argomenti correlati
- Esplora gli esempi di app Google Chat per iniziare a utilizzare l'API Chat.
Oltre a chiamare l'API Chat, le app di Chat possono anche:
- Ricevere e rispondere agli eventi di interazione con l'app Chat, come i messaggi inviati all'app Google Chat, in tempo reale.
- Abbonati agli eventi di Google Chat per intervenire o rispondere quando si verificano determinate attività o modifiche in Chat, ad esempio nuovi messaggi e modifiche all'appartenenza.