Questa pagina fornisce una panoramica su come creare componenti aggiuntivi di Google Workspace che estendono Google Chat.
I componenti aggiuntivi di Google Workspace che estendono Chat possono aiutare gli utenti a svolgere una delle seguenti operazioni:
- Visualizza l'anteprima dei link nei messaggi di Chat ed esegui azioni senza uscire dalla conversazione.
- Automatizza o esegui attività nelle applicazioni Google Workspace.
- Ricevere avvisi o notifiche su strumenti o servizi esterni.
Come funzionano i componenti aggiuntivi di Google Workspace in Chat
In Chat, i componenti aggiuntivi vengono visualizzati dagli utenti come app Google Chat. Per interagire con gli utenti, le app di chat possono:
- Inviare messaggi contenenti testo, schede ed elementi di interfaccia utente interattivi.
- Rispondere ai comandi slash.
- Apri dialoghi per aiutare gli utenti a completare procedure in più passaggi, ad esempio la compilazione dei dati dei moduli.
- Visualizza l'anteprima dei link nei messaggi allegando schede con informazioni utili che consentono agli utenti di intervenire direttamente dalla conversazione.
Inizia
Per iniziare a creare componenti aggiuntivi di Google Workspace che funzionino in Chat, consulta la seguente documentazione:
- Prova una guida rapida per creare un'app di chat di base utilizzando Google Apps Script o un servizio HTTP.
- Configura un'app di Chat e le relative funzionalità interattive utilizzando l'API Chat.
- Scopri i modi in cui puoi creare interfacce di chat utilizzando trigger, azioni e oggetti evento dei componenti aggiuntivi.
Limitazioni e problemi noti
Le seguenti funzionalità di Chat e dei componenti aggiuntivi non sono disponibili:
- Servizio Schede di Apps Script. Per utilizzare le azioni di chat e creare schede, restituisci invece oggetti JSON. Per esempi, consulta Aprire finestre di dialogo interattive e Visualizzare l'anteprima dei link.
- Schede di autorizzazione personalizzate. Per autenticare e concedere l'autorizzazione al tuo servizio da Chat, l'app Chat deve restituire una scheda di autorizzazione di base.
- Home page dei componenti aggiuntivi nella barra laterale di Chat. Se hai configurato un attivatore della home page per il plug-in, la home page viene visualizzata solo nella barra laterale delle altre applicazioni Google Workspace estese dal plug-in.
- Home page delle app di Chat, che vengono visualizzate nella scheda Home dei messaggi diretti con l'app Chat.
Se stai aggiornando un componente aggiuntivo di Google Workspace esistente, tieni presente i seguenti requisiti di configurazione per le app di Chat:
- Le impostazioni di installazione di Google Workspace Marketplace devono consentire sia ai privati che agli amministratori di Google Workspace di installare il componente aggiuntivo.
- Tutte le impostazioni di configurazione comuni nel manifest (
addons.common) del componente aggiuntivo vengono ignorate in Chat. Per configurare il componente aggiuntivo in modo che funzioni in Chat, devi attivare e configurare l'API Chat. Per la procedura, vedi Configurare un'app Google Chat. - Se stai creando un progetto con un servizio HTTP, devi attivare l'API Google Workspace Add-ons. Le risorse REST
deploymenteprojectsi applicano solo ai deployment del componente aggiuntivo in altre applicazioni Google Workspace. - Per eseguire il deployment e testare un componente aggiuntivo in Chat, devi utilizzare l'impostazione Visibilità dell'API Chat. Qualsiasi impostazione di visibilità o test che hai configurato nell' SDK di Google Workspace Marketplace viene ignorata. Per eseguire il deployment di una versione di test del componente aggiuntivo in Chat, consulta Testare le funzionalità interattive per le app Google Chat nella documentazione dell'API Chat.
- Se i tuoi componenti aggiuntivi sono pubblicati su Google Workspace Marketplace, non puoi salvare una bozza delle modifiche apportate alle impostazioni di configurazione dell'API Google Chat. Quando aggiorni le impostazioni di configurazione dell'API Chat, l'app Chat aggiornata è immediatamente disponibile per tutti gli utenti esistenti. Per aggiornare la tua scheda del marketplace, puoi creare una bozza prima di inviare le modifiche.