Dodatki Google Workspace mogą udostępniać niestandardowe interfejsy, gdy użytkownik wyświetla lub edytował 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.
Uzyskiwanie dostępu do 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 edytowania wydarzenia w Kalendarzu. Po wybraniu dodatku funkcjaeventAttachmentTriggertworzy interfejs wyboru załączników dodatku i zwraca go do Kalendarza Google w celu wyświetlenia.
Tworzenie interfejsu Kalendarza dodatku
Możesz rozszerzyć możliwości Kalendarza Google za pomocą dodatku do Google Workspace, wykonując te czynności:
- Zdecyduj, czy chcesz, aby Twój dodatek miał stronę główną związaną z Kalendarzem. 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 Przedłużanie interfejsu wydarzeń w Kalendarzu. - Zaimplementuj powiązane funkcje wywołania zwrotnego niezbędne do reagowania na interakcje 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ą dodatku w Kalendarzu Google, upewnij się, że w pliku manifestu dodatku znajduje się 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 wywoływana automatycznie, aby utworzyć stronę główną Kalendarza Google, gdy jest to potrzebne. Musisz zaimplementować tę funkcję, aby utworzyć i zwrócić pojedynczy obiekt Card lub tablicę obiektów Card, które składają się na 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 określa, jaki interfejs wyświetlić, gdy użytkownik edytuje wydarzenie w Kalendarzu, na podstawie czynników kontekstowych. 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 akceptuje obiekt event jako argument i musi zwracać pojedynczy obiekt Card lub tablicę obiektów Card, które Kalendarz będzie wyświetlany, gdy użytkownik ma otwarte wydarzenie.
Obiekty zdarzeń
Gdy użytkownik otworzy wydarzenie w Kalendarzu, tworzony jest obiekt wydarzenia, który jest przekazywany do funkcji aktywatora kontekstowego calendar.eventOpenTrigger. Funkcja reguły może używać informacji z tego obiektu zdarzenia do określania sposobu tworzenia kart dodatków lub sterowania ich działaniem. 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 w celu jego edycji, możesz też zdefiniować kontekst calendar.eventUpdateTrigger, który jest uruchamiany, gdy użytkownik zaktualizuje i zapisze wydarzenie w kalendarzu. Ta reguła uruchamia się 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.
Po uruchomieniu ten aktywator wykonuje funkcję aktywatora określoną w polu manifestu calendar.eventUpdateTrigger. Funkcja jest wykonywana przed zapisaniem zmiany w zdarzeniu w Kalendarzu.
calendar.eventUpdateTrigger zwykle służy do wykonywania co najmniej 1 z tych czynności:
- Zaktualizuj interfejs wydarzenia w Kalendarzu dodatku w odpowiedzi na zmiany wprowadzone przez użytkowników 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 dokonać zmian w danych wydarzenia w Kalendarzu (np. w liście uczestników), musisz ustawić w dodatkucalendar.currentEventAccesspole manifestu na WRITE lub READ_WRITE. Wymaga to też korzystania z https://www.googleapis.com/auth/calendar.addons.current.event.write
zakresu dodatku.
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 zewnętrznych narzędzi do prowadzenia rozmów wideo zawiera szczegółowe informacje o tworzeniu dodatku, który dodaje nowe rozwiązania do obsługi 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.