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 contrariocalendar.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 funzioneeventAttachmentTrigger
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:
- 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.
- Aggiungi il token appropriato
addOns.common
eaddOns.calendar
campi al progetto di script del componente aggiuntivo manifest, inclusi eventuali ambiti richiesti. - Se fornisci un modello di attribuzione
homepage,
di implementare
calendar.homepageTrigger
: per creare questa interfaccia. Puoi anche scegliere di utilizzarecommon.homepageTrigger
per più host Google Workspace. - 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. - 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.