Creare componenti aggiuntivi di Google Workspace

Scopri come progettare, creare e pubblicare componenti aggiuntivi di Google Workspace:

1. Determina le applicazioni Google Workspace in cui vuoi che il tuo componente aggiuntivo sia disponibile per gli utenti.
2. Configura i progetti del componente aggiuntivo e scegli un proprietario e i collaboratori.
3. Progetta e configura l'aspetto e il comportamento del componente aggiuntivo.
4. Crea il componente aggiuntivo.
5. Verifica gli ambiti OAuth del componente aggiuntivo.
6. Testa il componente aggiuntivo in una o più applicazioni Google Workspace.
7. Pubblica il componente aggiuntivo.

Crea un componente aggiuntivo con Apps Script o HTTP. Per confrontare i due, guarda il video "Apps Script vs. HTTP endpoints: Which should you choose? 🤔".

Scegliere le applicazioni in hosting di Google Workspace

Puoi configurare i componenti aggiuntivi di Google Workspace in modo che vengano visualizzati nelle seguenti applicazioni in hosting di Google Workspace:

• Gmail
• Google Calendar
• Google Chat
• Documenti Google
• Google Drive
• Google Meet
• Fogli Google
• Presentazioni Google

Per creare app per Google Workspace, vedi Estendere l'interfaccia utente di Google Workspace.

Configurare i progetti del componente aggiuntivo e scegliere un proprietario e dei collaboratori

Se crei il componente aggiuntivo in Apps Script, crei sia un progetto Apps Script sia un progetto Google Cloud. Se crei il componente aggiuntivo in una lingua diversa da Apps Script, devi solo creare un progetto Google Cloud.

Per creare un componente aggiuntivo, devi configurare sia un progetto script sia un progetto Cloud.

Prima di iniziare lo sviluppo di componenti aggiuntivi, scegli un singolo account utente di cui saranno proprietari i progetti e decidi quali altri account saranno collaboratori. Il proprietario dei progetti crea e gestisce i file di progetto e le impostazioni associate, mentre i collaboratori possono aiutare con la codifica e i test.

Avviso: se non aggiungi collaboratori ai tuoi progetti di componenti aggiuntivi, trasferisci la proprietà prima che l'account del proprietario venga chiuso o rimosso. In caso contrario, potresti perdere l'accesso al codice e alle impostazioni del componente aggiuntivo.

Progetti Apps Script

Prima di creare il componente aggiuntivo, consulta le quote e le limitazioni di Apps Script per allineare la progettazione del progetto a queste linee guida. Apps Script è ideale per lo sviluppo leggero di componenti aggiuntivi personali o interni con una base utenti ridotta. Se il tuo componente aggiuntivo richiede il supporto per molti utenti, una latenza ridotta o il controllo completo dell'infrastruttura, valuta la possibilità di utilizzare un runtime diverso.

Crea i file del progetto Apps Script del componente aggiuntivo in un Drive condiviso in modo che nessun singolo account abbia la proprietà esclusiva. Se inserisci il file di script del componente aggiuntivo in un Drive condiviso, tutti i collaboratori avranno accesso al progetto di script.

Quando pubblichi un componente aggiuntivo, l'editore è un singolo account utente. L'account di pubblicazione deve disporre dell'accesso in modifica al progetto dello script, ma non deve esserne il proprietario.

Per creare un progetto Apps Script, vedi Progetti di script.

Progetti Google Cloud

Aggiungi collaboratori al progetto Cloud del componente aggiuntivo. In questo modo il tuo team può sempre accedere alle impostazioni cloud del componente aggiuntivo.

Per creare un progetto Google Cloud, consulta Creare un progetto Google Cloud.

Progettare e configurare l'aspetto e il comportamento del componente aggiuntivo

Decidi l'aspetto e il comportamento del componente aggiuntivo prima di crearlo. Valuta quali casi d'uso risolve il componente aggiuntivo. Inizia con un design di base per iniziare a lavorare, quindi aggiungi i perfezionamenti.

Suggerimento:inizia con una scheda della home page di base, poi aggiungi altri widget, schede, navigazione e altri comportamenti. Prendi in considerazione le schede contestuali attivate da un'azione utente nell'applicazione in hosting, ad esempio l'apertura di una conversazione di Gmail o di un evento nel calendario.

Consulta la Guida di stile dei componenti aggiuntivi di Google Workspace per linee guida su come progettare l'esperienza utente del tuo componente aggiuntivo.

Configurare il manifest del componente aggiuntivo

Implementa il design nel manifest del componente aggiuntivo. Configura l'aspetto e il comportamento del componente aggiuntivo nel manifest, incluse le applicazioni host di Google Workspace che il componente aggiuntivo estende.

Per maggiori dettagli, vedi Manifest per il componente aggiuntivo di Google Workspace.

Man mano che aggiungi codice e funzionalità, aggiorna il manifest in base alle necessità per definire l'aspetto e il comportamento del componente aggiuntivo richiesto.

Configurare l'aspetto e il comportamento dell'app Google Chat

Se progetti un componente aggiuntivo che estende Google Chat, utilizza l'API Google Chat per configurare l'aspetto e il comportamento di un'app di chat. Per i passaggi, consulta Utilizzare l'API Google Chat.

Crea il componente aggiuntivo

Implementa un'interfaccia basata su schede per il componente aggiuntivo. Utilizza Card service o, se utilizzi un altro linguaggio di codifica, restituisci JSON formattato per il rendering dell'interfaccia come schede.

Implementa le funzioni trigger specificate nel manifest del componente aggiuntivo. Se il tuo componente aggiuntivo si connette a un servizio di terze parti utilizzando OAuth, configura OAuth per quel servizio.

Costruire carte

Definisci un'interfaccia utente del componente aggiuntivo creando oggetti Card e aggiungendo widget. Le funzioni trigger specificate nel manifest devono restituire un singolo oggetto Card o un array di oggetti Card che rappresentano diverse "pagine" dell'interfaccia del componente aggiuntivo. Il componente aggiuntivo può anche creare e visualizzare nuove schede in risposta alle azioni dell'utente.

In Apps Script, crea schede utilizzando la classe CardBuilder. Ogni scheda richiede un CardHeader e uno o più CardSections. Riempi ogni sezione della scheda con i singoli widget che compongono l'interfaccia. I widget di interazione sono in genere collegati ad azioni per definire il loro comportamento di interazione.

Dopo aver aggiunto tutte le sezioni e tutti i widget alla tua scheda tramite il relativo CardBuilder, chiama CardBuilder.build per creare l'oggetto Card corrispondente.

Nota: se non chiami build dopo aver utilizzato le classi builder nei risultati del servizio schede, si verificano errori di tipo. Le funzioni di attivazione devono restituire oggetti Card. La restituzione di oggetti CardBuilder genera un errore.

Utilizza i servizi Apps Script integrati](/apps-script/guides/services/) come CalendarApp per recuperare le informazioni da visualizzare nelle schede del componente aggiuntivo. Utilizzare i dati di servizi non Google.

Se il tuo componente aggiuntivo deve accedere ad API non Google che richiedono OAuth, configura e connettiti a quel servizio. Consulta la guida Connessione a servizi non Google.

Ordine di costruzione

Quando crei una carta, inizia dall'alto. Utilizza questo ordine di costruzione:

1. Crea il widget.
2. Aggiungi il widget alla sezione della scheda.
3. Ripeti l'operazione finché la sezione della scheda non contiene tutti i widget.
4. Aggiungi la sezione della carta alla carta.

Questo perché quando aggiungi un widget a una scheda o a una sezione di schede, in realtà stai aggiungendo una copia di quel widget. Eventuali modifiche apportate all'oggetto widget dopo l'aggiunta non vengono riportate nella scheda finale.

Avviso: aggiungi un widget a una scheda o a una sezione di schede dopo averlo creato. Aggiungi una sezione a una scheda dopo che è stata completamente compilata con i widget. Non modificare i widget o le sezioni dopo averli aggiunti. Per modificare un widget aggiunto, ricrea la sezione o la scheda.

Universal Action

Utilizza le azioni universali per fornire funzionalità indipendenti dal contesto. Le azioni universali sono voci di menu disponibili nell'interfaccia utente del componente aggiuntivo, indipendentemente dalla scheda. Tutte le azioni universali definite vengono visualizzate nel menu della scheda del componente aggiuntivo.

Per maggiori dettagli, consulta Azioni universali.

Verifica gli ambiti OAuth del componente aggiuntivo

Gli ambiti definiscono le azioni che il componente aggiuntivo può eseguire per conto di un utente. I componenti aggiuntivi devono avere solo gli ambiti necessari per funzionare.

Nei progetti di componenti aggiuntivi, imposta gli ambiti del componente aggiuntivo per assicurarti che il componente aggiuntivo utilizzi il set di ambiti meno permissivo possibile. Definisci gli ambiti nel manifest del componente aggiuntivo.

Per maggiori dettagli, consulta la sezione Ambiti.

Testa il componente aggiuntivo

Puoi testare i componenti aggiuntivi non pubblicati installandoli prima. Una volta installato e autorizzato, utilizza il componente aggiuntivo nel tuo account per testarne l'aspetto e il comportamento nelle applicazioni in hosting che estende. Verifica che il componente aggiuntivo si comporti come previsto per contesti e azioni utente.

Per iniziare a testare il componente aggiuntivo, consulta le seguenti guide:

• Testare ed eseguire il debug dei componenti aggiuntivi di Google Workspace di Apps Script
• Testare ed eseguire il debug dei componenti aggiuntivi HTTP di Google Workspace
• Testare le funzionalità interattive per le app Google Chat

Pubblica il componente aggiuntivo

La pubblicazione rende il componente aggiuntivo disponibile per gli altri. Prima di pubblicare, rivedi la panoramica della pubblicazione. La pubblicazione è un processo complesso che richiede preparazione.

I componenti aggiuntivi di Google Workspace vengono pubblicati su Google Workspace Marketplace. I componenti aggiuntivi disponibili pubblicamente richiedono una revisione dell'app prima di essere pubblicati.

Per maggiori dettagli, consulta Pubblicazione di componenti aggiuntivi di Google Workspace.