Dodatki Google Workspace mogą wyświetlać niestandardowe interfejsy, gdy użytkownik przegląda lub edytuje kalendarze i wydarzenia w Kalendarzu. Dzięki temu możesz udostępniać użytkownikowi dodatkowe informacje, automatyzować zadania i łączyć systemy innych firm z Kalendarzem Google.
Podczas tworzenia interfejsu dodatku do Kalendarza Google możesz podać stronę główną. Możesz użyć tej samej strony głównej dla wielu gospodarzy lub zaprojektować inną dla Kalendarza Google.
Twoje rozszerzenie może też zdefiniować interfejs, który pojawia się, gdy użytkownik otworzy wydarzenie w Kalendarzu.
Otwieranie interfejsu dodatku
W zależności od sposobu otwarcia dodatek Google Workspace może zdefiniować interfejs strony głównej, interfejs wydarzenia w Kalendarzu Google, interfejs wyboru załącznika lub wszystkie te interfejsy:
- Jeśli użytkownik kliknie ikonę dodatku w widoku kalendarza, dodatek wykona odpowiednią funkcję
calendar.homepageTrigger(jeśli jest dostępna). Ta funkcja tworzy i zwraca kartę na stronie głównej, która jest wyświetlana w Kalendarzu. Jeśli nie zdefiniowano funkcjicalendar.homepageTrigger, wyświetla się ogólna karta strony głównej. - Jeśli użytkownik otworzy zdarzenie w Kalendarzu, a następnie kliknie ikonę dodatku, lub jeśli dodatek jest otwarty, gdy użytkownik otworzy zdarzenie, dodatek wykona odpowiednią funkcję
eventOpenTrigger(jeśli jest dostępna). Ta funkcja tworzy interfejs wydarzenia w Kalendarzu dodatku i zwraca go do Kalendarza Google w celu wyświetlenia. - Jeśli dodatek definiuje funkcję
eventAttachmentTrigger, pojawi się jako dostawca załączników, gdy użytkownik kliknie Dodaj załącznik podczas edycji wydarzenia w Kalendarzu. Gdy użytkownik wybierze dodatek, funkcjaeventAttachmentTriggertworzy interfejs wyboru załączników dodatku i zwraca go do Kalendarza Google w celu wyświetlenia.
Tworzenie interfejsu dodatku do Kalendarza
Aby rozszerzyć Kalendarz Google za pomocą dodatku Google Workspace:
- Zdecyduj, czy dodatek ma mieć stronę główną w Kalendarzu. Zdecyduj też, czy chcesz udostępnić niestandardowy interfejs podczas edycji wydarzeń w kalendarzu przez użytkownika.
- Dodaj odpowiednie pola
addOns.commoniaddOns.calendardo manifestu projektu skryptu dodatku, w tym wymagane zakresy. - Jeśli udostępniasz stronę główną w Kalendarzu, użyj funkcji
calendar.homepageTrigger, aby utworzyć ten interfejs. Możesz też użyć interfejsucommon.homepageTriggerdla wielu hostów Google Workspace. - Jeśli udostępniasz interfejs wydarzenia w Kalendarzu, musisz zaimplementować funkcję
calendar.eventOpenTrigger, aby utworzyć ten interfejs. Więcej informacji znajdziesz w artykule Rozszerzanie interfejsu wydarzenia w Kalendarzu. - Wdrożyć powiązane funkcje wywołania zwrotnego, które są potrzebne do reagowania na interakcje użytkownika z interfejsem użytkownika, takie jak kliknięcia przycisków.
Strony główne kalendarza
Kalendarz Google obsługuje wyświetlanie stron głównych dodatków do Google Workspace.
Aby wyświetlić wspólną stronę główną wtyczki w Kalendarzu Google, upewnij się, że w pliku manifestu wtyczki jest pole addOns.calendar.
Możesz też dodać do pliku manifestu dodatku element calendar.homepageTrigger, aby wyświetlać stronę główną związaną z Kalendarzem.
W obu przypadkach musisz podać nazwę funkcji reguły strony głównej w projekcie skryptu dodatku. Ta funkcja jest automatycznie wywoływana, aby w razie potrzeby utworzyć stronę główną Kalendarza Google. Musisz zaimplementować tę funkcję, aby utworzyć i zwrócić pojedynczy obiekt Card lub tablicę obiektów Card, które tworzą stronę główną. Funkcja reguły strony głównej otrzymuje obiekt zdarzenia jako parametr, który zawiera ogólne informacje, takie jak platforma klienta. Dane obiektu zdarzenia możesz wykorzystać do dostosowania tworzenia strony głównej.
Rozszerzanie interfejsu wydarzenia w Kalendarzu
Kalendarz Google używa przełącznika kontekstowego, aby określić, jaki interfejs (jeśli w ogóle) wyświetlić, gdy użytkownik edytuje wydarzenie w Kalendarzu. Gdy wyzwalacz zostanie uruchomiony, wykona funkcję wyzwalacza kontekstowego określoną przez pole calendar.eventOpenTrigger w pliku manifestu dodatku.
Musisz zaimplementować funkcję o nazwie podanej w polu calendar.eventOpenTrigger. Ta funkcja przyjmuje jako argument obiekt zdarzenia i musi zwracać pojedynczy obiekt Card lub tablicę obiektów Card, które mają być wyświetlane w Kalendarzu, gdy użytkownik otworzy zdarzenie.
Obiekty zdarzeń
Gdy użytkownik otworzy wydarzenie w kalendarzu, zostanie utworzony obiekt zdarzenia i przekazany do funkcji kontekstowego aktywatora calendar.eventOpenTrigger. Funkcja reguły może używać informacji z tego obiektu zdarzenia do określania sposobu tworzenia kart dodatku lub kontrolowania zachowania dodatku. Obiekty zdarzeń są też tworzone i przekazywane do funkcji homepageTrigger, gdy dodatek jest otwierany po raz pierwszy, a użytkownik klika lub wybiera widżety interaktywne.
Pełna struktura obiektów zdarzeń jest opisana w artykule Obiekty zdarzenia. Gdy Kalendarz jest hostującą aplikacją dodatku, obiekty zdarzeń wywoływanych przez kontekst i interakcje z widżetem zawierają pole Obiekt zdarzenia w Kalendarzu, które zawiera informacje o kliencie dotyczące Kalendarza.
Aktualizowanie wydarzeń w kalendarzu
Oprócz kontekstu calendar.eventOpenTrigger, który jest uruchamiany, gdy użytkownik otworzy wydarzenie w kalendarzu, aby je edytować, możesz też zdefiniować kontekst calendar.eventUpdateTrigger, który jest uruchamiany, gdy użytkownik zaktualizuje i zapisze wydarzenie w kalendarzu. Ten reguła działa tylko wtedy, gdy użytkownik wprowadzi co najmniej jedną z tych zmian:
- Dodaje co najmniej 1 uczestnika.
- Usuwanie co najmniej 1 uczestnika.
- Dodaje lub przełącza się na inne rozwiązanie do obsługi rozmów wideo.
Gdy ten reguła zostanie uruchomiona, wykona funkcję reguły określoną przez pole manifestucalendar.eventUpdateTrigger. Funkcja jest wykonywana przed zapisaniem zmiany w wydarzeniu w Kalendarzu.
calendar.eventUpdateTrigger
zwykle służy do wykonywania co najmniej jednej z tych czynności:
- aktualizować interfejs wydarzenia w Kalendarzu w odpowiedzi na zmiany wprowadzone przez użytkownika w wydarzeniu w Kalendarzu.
- synchronizować dane wydarzenia w Kalendarzu z systemem innej firmy, takim jak system rozmów wideo połączony z Kalendarzem Google.
Jeśli potrzebujesz dodatku, aby dostosować dane wydarzenia w Kalendarzu (np. listę uczestników), musisz ustawić w dodatku pole manifestu calendar.currentEventAccess na WRITE lub READ_WRITE. Wymaga to również https://www.googleapis.com/auth/calendar.addons.current.event.write
zakresu.
Dodawanie rozwiązań do obsługi konferencji
Rozwiązania do rozmów wideo to opcje firm zewnętrznych, które użytkownicy mogą dołączać do wydarzeń w Kalendarzu Google. Dokumentacja Podsumowanie funkcji rozmów wideo zewnętrznych zawiera szczegółowe informacje o tworzeniu dodatku, który dodaje nowe rozwiązania do rozmów wideo. Nie musisz tworzyć interfejsu dla tego typu rozszerzeń. Dodane rozwiązania będą widoczne jako opcje w menu w interfejsie wydarzenia w Kalendarzu Google.