Creare le interfacce di Google Calendar

I componenti aggiuntivi di Google Workspace possono fornire quando l'utente visualizza o modifica calendari ed eventi di Calendar. Ciò ti consente di fornire all'utente ulteriori informazioni pertinenti, automatizzare attività e collegare sistemi di terze parti a Google Calendar.

Quando crei l'interfaccia di un componente aggiuntivo per Google Calendar, puoi fornire un'interfaccia homepage. Puoi utilizzare lo stesso home page per più host o progettane una specifica per Google Calendar.

Il componente aggiuntivo può anche definire un'interfaccia che viene visualizzata quando l'utente un evento di Calendar aperto.

Accesso all'interfaccia utente del componente aggiuntivo

A seconda di come viene aperto, un componente aggiuntivo di Google Workspace può definire l'interfaccia della home page, un'interfaccia degli eventi di Google Calendar, un'interfaccia di selezione degli allegati o tutti e tre:

  • Se un utente fa clic sull'icona del componente aggiuntivo in visualizzazione calendario, il componente aggiuntivo viene eseguito il token calendar.homepageTrigger corrispondente (se presente). Questa funzione crea e restituisce una scheda della home page in Calendar per la visualizzazione. In caso contrario calendar.homepageTrigger viene definita una funzione, viene visualizzata una scheda generica della home page.
  • Se l'utente apre un evento di Calendar e poi fa clic sull'icona del componente aggiuntivo, oppure il componente aggiuntivo è aperto quando l'utente apre un evento, che esegue eventOpenTrigger (se presente). Questa funzione crea l'evento di Calendar del componente aggiuntivo e torna a Google Calendar per la visualizzazione.
  • Se il componente aggiuntivo definisce una funzione eventAttachmentTrigger, il componente aggiuntivo viene visualizzato come fornitore di allegati quando l'utente fa clic su Aggiungi allegato durante la modifica di un evento di Calendar. Quando il componente aggiuntivo è selezionato, la funzione eventAttachmentTrigger crea l'allegato del componente aggiuntivo e la restituisce a Google Calendar per la visualizzazione.

Creazione dell'interfaccia del componente aggiuntivo di Calendar

Puoi estendere Google Calendar con una Segui questi passaggi:

  1. Decidi se vuoi che il tuo componente aggiuntivo abbia una dimensione specifica di Calendar homepage. Decidi inoltre se vuoi fornire un'interfaccia personalizzata mentre l'utente la modifica degli eventi nel calendario.
  2. Aggiungi il token appropriato addOns.common e addOns.calendar campi al progetto di script del componente aggiuntivo manifest, inclusi eventuali ambiti richiesti.
  3. Se fornisci un modello di attribuzione homepage, di implementare calendar.homepageTrigger: per creare questa interfaccia. Puoi anche scegliere di utilizzare common.homepageTrigger per più host Google Workspace.
  4. Se fornisci un'interfaccia di eventi di Calendar, devi implementare un calendar.eventOpenTrigger per creare questa interfaccia. Consulta Estensione dell'interfaccia degli eventi di Calendar per maggiori dettagli.
  5. Implementare le funzioni di callback associate necessarie per rispondere alla richiesta Interazioni con l'interfaccia utente, come i clic sui pulsanti.

Home page del calendario

Google Calendar supporta la visualizzazione delle home page del componente aggiuntivo di Google Workspace. Per visualizzare la home page comune del componente aggiuntivo in Google Calendar, assicurati semplicemente che è una addOns.calendar nel file manifest del componente aggiuntivo.

In alternativa, aggiungi un elemento calendar.homepageTrigger al file manifest del componente aggiuntivo per fornire una home page specifica di Calendar.

In entrambi i casi, devi specificare il nome di una funzione di trigger della home page nel progetto di script del componente aggiuntivo. Questa funzione viene chiamata automaticamente per creare home page di Google Calendar quando è necessario. Devi implementare questa funzione per creare e restituirà un singolo Card o un array di Card: gli oggetti che compongono la home page. Alla funzione di trigger della home page viene inviato oggetto evento parametro contenente alcune informazioni generali come il parametro completamente gestita. Puoi utilizzare i dati dell'oggetto evento per personalizzare la costruzione dell'oggetto homepage.

Estensione dell'interfaccia degli eventi di Calendar

Google Calendar si basa su un trigger contestuale per determinare quale interfaccia (se presenti) da visualizzare quando l'utente modifica un evento nel calendario. Quando viene attivato si attiva, esegue la funzione di trigger contestuale specificata calendar.eventOpenTrigger nel campo manifest del componente aggiuntivo.

Devi implementare la funzione denominata nel calendar.eventOpenTrigger . Questa funzione accetta un oggetto evento come e deve restituire un solo Card o un array di Card oggetti per Calendar quando l'evento è aperto.

Oggetti evento

Viene creato un oggetto evento passati al calendar.eventOpenTrigger: di attivazione contestuale quando un utente apre un evento nel calendario. La funzione trigger può utilizzare le informazioni in questo evento l'oggetto per determinare come costruire le schede dei componenti aggiuntivi o controllarli comportamento degli utenti. Anche gli oggetti evento vengono creati e passati homepageTrigger funzioni alla prima apertura di un componente aggiuntivo e quando l'utente fa clic o seleziona widget interattivi.

La struttura completa degli oggetti evento è descritta in Oggetti evento. Se Calendar è l'app host che agisce per il componente aggiuntivo, trigger contestuale e Gli oggetti evento di interazione con il widget includono Oggetto evento Calendar che contiene informazioni sul client specifiche di Calendar.

Aggiornamento degli eventi di Calendar

Oltre alla configurazione contestuale calendar.eventOpenTrigger che si attiva quando un utente apre un evento di Calendar per la modifica, puoi anche definire calendar.eventUpdateTrigger che si attiva quando l'utente aggiorna e salva un evento nel calendario. Solo questo trigger si attiva se l'utente apporta una o più delle seguenti modifiche:

  • Aggiunge uno o più partecipanti.
  • Rimuove uno o più partecipanti.
  • Aggiunge o passa a un'altra soluzione per conferenze.

Quando si attiva, questo attivatore esegue della funzione di trigger specificata calendar.eventUpdateTrigger . La funzione viene eseguita prima che la modifica dell'evento di Calendar sia salvate.

La calendar.eventUpdateTrigger viene generalmente utilizzato per eseguire una o più delle seguenti operazioni:

  • Aggiornare l'interfaccia degli eventi di Calendar del componente aggiuntivo in risposta alle modifiche degli utenti all'evento di Calendar.
  • Sincronizzare i dati sugli eventi di Calendar con un sistema di terze parti, ad esempio un servizio di conferenza collegato a Google Calendar.

Se hai bisogno di un componente aggiuntivo per modificare i dati di un evento di Calendar (ad esempio come elenco di partecipanti), devi impostare il componente aggiuntivo calendar.currentEventAccess campo manifest su WRITE o READ_WRITE. Anche questo richiede che il componente aggiuntivo https://www.googleapis.com/auth/calendar.addons.current.event.write ambito.

Aggiunta di soluzioni per conferenze

Soluzioni per conferenze rappresentano le opzioni di conferenza di terze parti a cui gli utenti possono accedere Eventi di Google Calendar. La Panoramica delle conferenze di terze parti la documentazione fornisce dettagli su come creare un componente aggiuntivo che aggiunge nuovi soluzioni per videoconferenze. Non è necessario creare una UI per questo tipo di estensione; le soluzioni aggiunte vengono visualizzate semplicemente come opzioni nel menu a discesa dell'interfaccia utente degli eventi di Google Calendar.