Questa sezione spiega in che modo un'app Google Chat può effettuare chiamate l'API Chat, che consente alle app di Chat, ad esempio, creare uno spazio, aggiungere persone e pubblicare un messaggio.
Autenticazione
La chiamata all'API Chat richiede l'autenticazione. Ciascuna Il metodo API Chat richiede autenticazione degli utenti (per eseguire azioni o accedere per conto di un utente) o autenticazione app (per eseguire azioni o accedere ai dati come app di Chat). Alcune supportano sia l'autenticazione utente sia quella delle app.
Per scoprire di più sull'autenticazione in Chat, vedi Panoramica dell'autenticazione.
Librerie client
Il metodo consigliato per la maggior parte degli sviluppatori di chiamare l'API Google Chat è con il nostro supporto ufficiale Librerie client di Cloud per il tuo linguaggio preferito, come Python, Java o Node.js.
Se scrivi codice con Google Apps Script, utilizza la Servizio Chat avanzato anziché installare una libreria client.
Concetti dell'API Google Chat
Servizi gRPC o risorse e metodi REST concedi l'accesso a spazi di Chat, membri dello spazio, messaggi, messaggi reazioni, allegati dei messaggi, eventi nello spazio e stati di lettura degli utenti.
- Spazi
Gli spazi sono luoghi in cui persone e app possono conversare e condividere file. Là esistono vari tipi di spazi. I messaggi diretti sono conversazioni 1:1 tra due utenti o un utente e un'app di Chat. Gruppo le chat sono conversazioni tra tre o più utenti e App di chat. Gli spazi con nome sono luoghi permanenti in cui gli utenti inviano messaggi, condividere file e collaborare.
Riferimento delle risorse:
Ad esempio, consulta:
- Membri
I membri sono utenti e app di Chat che partecipano o sono è stato invitato in uno spazio.
Riferimento delle risorse:
Ad esempio, consulta:
- Messaggi
I messaggi includono testo e carta le comunicazioni pubblicate negli spazi. Ai messaggi possono essere allegati file. Le persone possono reagire ai messaggi aggiungendo loro emoji.
Riferimento delle risorse:
Ad esempio, consulta:
- Reazioni
Le reazioni rappresentano le emoji che le persone utilizzano per reagire a un messaggio, ad esempio: 👍, ↁ e 🇦.
Riferimento delle risorse:
Ad esempio, consulta:
- Contenuti multimediali e allegati
Contenuti multimediali rappresenta un file caricato su Google Chat, come immagini, video e documenti.
Riferimento risorsa multimediale (non disponibile in RPC):
Gli allegati sono istanze di contenuti multimediali (file) allegati ai messaggi.
Riferimento delle risorse:
Ad esempio, consulta:
- Eventi dello spazio
Gli eventi dello spazio rappresentano le modifiche a uno spazio o ai relativi spazi. risorse figlio, inclusi membri, messaggi e reazioni.
Riferimento delle risorse:
Ad esempio, consulta:
- Stati di lettura dell'utente
Gli stati di lettura dell'utente sono risorse singleton che rappresentano i dettagli di un l'ultimo messaggio letto da un utente specificato in uno spazio di Google Chat o in un messaggio .
Riferimento della risorsa per lo stato di lettura dello spazio:
Riferimento delle risorse per lo stato di lettura del thread:
Ad esempio, consulta:
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 di Chat come i messaggi inviati all'app Google Chat, in tempo reale.
- Iscriversi agli eventi di Google Chat di agire o di rispondere quando determinati le attività o le modifiche si verificano in Chat, come l'aggiunta di nuovi messaggi modifiche alle iscrizioni.