Dodatki do Google Workspace mogą zapewniać niestandardowe interfejsy, gdy użytkownik wyświetla lub edytuje kalendarze i wydarzenia w Kalendarzu. Dzięki temu możesz przekazać użytkownikowi dodatkowe istotne informacje, zautomatyzować zadania i połączyć systemy innych firm z Kalendarzem Google.
Tworząc dodatek do Kalendarza Google, możesz określić stronę główną. Możesz użyć tej samej strony głównej dla wielu hostów lub zaprojektować konkretną stronę na potrzeby Kalendarza Google.
Dodatek może też definiować 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 do Google Workspace może definiować interfejs strony głównej, interfejs wydarzeń Kalendarza Google, interfejs wyboru załączników lub wszystkie 3 elementy:
- Gdy 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ę strony głównej do wyświetlania w Kalendarzu. Jeśli nie zdefiniowano żadnej funkcjicalendar.homepageTrigger, wyświetlana jest ogólna karta na stronie głównej. - Jeśli użytkownik otworzy wydarzenie w Kalendarzu, a następnie kliknie ikonę dodatku lub dodatek zostanie otwarty, gdy użytkownik otworzy wydarzenie, dodatek wykona odpowiednią funkcję
eventOpenTrigger(jeśli jest dostępna). Ta funkcja tworzy interfejs wydarzeń dla dodatku w Kalendarzu i wraca do Kalendarza Google, aby go wyświetlić. - Jeśli dodatek definiuje funkcję
eventAttachmentTrigger, jest on wyświetlany jako dostawca załączników, gdy użytkownik kliknie Dodaj załącznik podczas edytowania wydarzenia w Kalendarzu. Po wybraniu dodatku funkcjaeventAttachmentTriggerstworzy interfejs wyboru załączników dodatku i zwraca go do Kalendarza Google, aby go wyświetlić.
Tworzenie interfejsu dodatku Kalendarz
Możesz rozszerzyć Kalendarz Google o dodatek Google Workspace, wykonując te czynności:
- Zdecyduj, czy chcesz, aby dodatek miał określoną stronę główną Kalendarza. Zdecyduj też, czy chcesz udostępnić niestandardowy interfejs, gdy użytkownik będzie edytować wydarzenia w Kalendarzu.
- Dodaj odpowiednie pola
addOns.commoniaddOns.calendardo pliku manifestu projektu dodatku wraz ze wszystkimi wymaganymi zakresami. - Jeśli udostępniasz stronę główną Kalendarza, zaimplementuj funkcję
calendar.homepageTrigger, aby utworzyć ten interfejs. Możesz też używać interfejsucommon.homepageTriggerdla wielu hostów Google Workspace. - Jeśli udostępniasz interfejs wydarzeń z Kalendarza, musisz zaimplementować funkcję
calendar.eventOpenTrigger, aby utworzyć ten interfejs. Więcej informacji znajdziesz w artykule Rozszerzanie interfejsu wydarzeń Kalendarza. - Zaimplementuj powiązane funkcje wywołania zwrotnego niezbędne do reagowania na interakcje użytkownika w interfejsie, np. na kliknięcia przycisku.
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ć calendar.homepageTrigger do pliku manifestu dodatku, aby udostępnić stronę główną Kalendarza.
W obu przypadkach musisz podać nazwę funkcji aktywatora strony głównej w projekcie skryptu dodatku. W razie potrzeby funkcja ta jest automatycznie wywoływana
do utworzenia strony głównej Kalendarza Google. Musisz wdrożyć tę funkcję, by utworzyć i zwrócić pojedynczy obiekt Card lub tablicę obiektów Card, które składają się na stronę główną. Funkcja aktywatora strony głównej przekazuje obiekt zdarzenia jako parametr, który zawiera ogólne informacje, np. o platformie klienta. Za pomocą danych obiektu zdarzenia możesz dostosować konstrukcję strony głównej.
Rozszerzenie interfejsu wydarzeń w Kalendarzu
Kalendarz Google używa czynnika uruchamiającego kontekstowego, aby określić, jaki interfejs (o ile w ogóle) wyświetlić, gdy użytkownik edytuje wydarzenie w Kalendarzu. Uruchomienie aktywatora powoduje wykonanie funkcji aktywatora kontekstowego określonej w polu calendar.eventOpenTrigger w pliku manifestu dodatku.
Musisz zaimplementować funkcję o nazwie w polu calendar.eventOpenTrigger. Ta funkcja akceptuje obiekt zdarzenia jako argument i musi zwracać pojedynczy obiekt Card lub tablicę obiektów Card, aby Kalendarz był wyświetlany, gdy użytkownik ma otwarte wydarzenie.
Obiekty zdarzeń
Gdy użytkownik otworzy wydarzenie w Kalendarzu, tworzony jest obiekt zdarzenia, który jest przekazywany do funkcji aktywatora kontekstowego calendar.eventOpenTrigger. Funkcja aktywatora może używać informacji z tego obiektu zdarzenia do określania sposobu tworzenia kart dodatków lub kontrolowania działania dodatku. Obiekty zdarzeń są też tworzone i przekazywane do funkcji homepageTrigger przy pierwszym uruchomieniu dodatku oraz po kliknięciu lub wybraniu widżetów interaktywnych przez użytkownika.
Pełną strukturę obiektów zdarzeń opisano w sekcji Obiekty zdarzeń. Gdy Kalendarz jest aplikacją hostującą dodatek, aktywator kontekstowy i obiekty zdarzeń interakcji z widżetem zawierają pole Obiekt wydarzenia w Kalendarzu, które zawiera informacje specyficzne dla Kalendarza.
Aktualizowanie wydarzeń w Kalendarzu
Oprócz kontekstu calendar.eventOpenTrigger, który jest uruchamiany, gdy użytkownik otworzy wydarzenie w Kalendarzu do edycji, możesz też zdefiniować element calendar.eventUpdateTrigger, który będzie się uruchamiać, 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.
- Usuwa co najmniej 1 uczestnika.
- Dodaje inne rozwiązanie do obsługi rozmów wideo lub przełącza je na inne.
Uaktywnienie tego aktywatora wykonuje funkcję aktywatora określoną w polu manifestu calendar.eventUpdateTrigger. Funkcja jest wykonywana przed zapisaniem edycji wydarzenia z Kalendarza.
calendar.eventUpdateTrigger służy zwykle do wykonywania co najmniej 1 z tych czynności:
- zaktualizować interfejs wydarzenia w Kalendarzu dodatku w odpowiedzi na zmiany wprowadzone przez użytkowników w wydarzeniu w Kalendarzu;
- Synchronizowanie danych wydarzeń w Kalendarzu z systemem innej firmy, na przykład z systemem do obsługi rozmów wideo połączonym z Kalendarzem Google.
Jeśli chcesz, aby dodatek wprowadzał zmiany w danych wydarzenia w Kalendarzu (na przykład na liście uczestników), ustaw pole manifestu calendar.currentEventAccess dodatku na WRITE lub READ_WRITE. Dodatek musi też mieć https://www.googleapis.com/auth/calendar.addons.current.event.write
zakres.
Dodawanie rozwiązań do obsługi rozmów wideo
Rozwiązania do prowadzenia konferencji to opcje innych firm, które użytkownicy mogą dołączać do wydarzeń w Kalendarzu Google. Szczegółowe informacje na temat tworzenia dodatku dodającego nowe rozwiązania do obsługi rozmów wideo znajdziesz w dokumentacji omówienia rozmów wideo z innymi firmami. W przypadku tego typu rozszerzeń nie trzeba tworzyć interfejsu użytkownika. Dodane rozwiązania są widoczne jako opcje w menu w interfejsie wydarzeń w Kalendarzu Google.