Tworzenie interfejsów Kalendarza Google

Dodatki do Google Workspace oferują niestandardowe interfejsy, gdy użytkownik wyświetla lub edytuje kalendarze oraz wydarzenia w Kalendarzu. Dzięki temu możesz udostępniać użytkownikowi dodatkowe ważne informacje, automatyzować zadania i łączyć z Kalendarzem Google systemy innych firm.

Tworząc interfejs dodatku do Kalendarza Google, możesz podać stronę główną. Możesz użyć tej samej strony głównej dla wielu hostów lub zaprojektować konkretną stronę dla Kalendarza Google.

Dodatek może też zdefiniować interfejs, który wyświetla 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 zdefiniować interfejs strony głównej, interfejs wydarzenia w Kalendarzu Google, interfejs wyboru załącznika albo wszystkie 3 elementy:

  • Jeśli użytkownik kliknie ikonę dodatku w widoku kalendarza, dodatek uruchomi 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 funkcji calendar.homepageTrigger, wyświetla się standardowa karta strony głównej.
  • Jeśli użytkownik otworzy wydarzenie w Kalendarzu, a następnie kliknie ikonę dodatku lub dodatek jest otwarty, gdy użytkownik otwiera wydarzenie, dodatek uruchomi odpowiednią funkcję eventOpenTrigger (jeśli jest dostępna). Ta funkcja tworzy interfejs Kalendarza w Kalendarzu Google dodatku i wraca 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 funkcja eventAttachmentTrigger tworzy 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:

  1. Zdecyduj, czy chcesz, aby Twój dodatek miał stronę główną związaną z Kalendarzem. Możesz też określić, czy podczas edytowania wydarzeń w Kalendarzu przez użytkowników ma być dostępny interfejs niestandardowy.
  2. Dodaj odpowiednie pola addOns.common i addOns.calendar do manifestu projektu skryptu dodatku, wraz ze wszystkimi wymaganymi zakresami.
  3. Jeśli udostępniasz stronę główną Kalendarza, zaimplementuj funkcję calendar.homepageTrigger, by utworzyć ten interfejs. Możesz też używać interfejsu common.homepageTrigger dla wielu hostów Google Workspace.
  4. 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.
  5. 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ć calendar.homepageTrigger do pliku manifestu dodatku, aby udostępnić stronę główną Kalendarza.

W obu przypadkach musisz podać nazwę funkcji aktywującej stronę główną w projekcie skryptu dodatku. Funkcja ta jest w razie potrzeby automatycznie wywoływana w celu utworzenia strony głównej Kalendarza Google. 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 aktywatora strony głównej jest przekazywana do obiektu zdarzenia jako parametru zawierającego ogólne informacje, np. o platformie klienta. Możesz wykorzystać dane obiektu zdarzenia, aby dostosować konstrukcję strony głównej.

Rozszerzanie interfejsu wydarzeń w Kalendarzu

Kalendarz Google określa, jaki interfejs wyświetlić, gdy użytkownik edytuje wydarzenie w Kalendarzu, na podstawie czynników kontekstowych. Po uruchomieniu aktywatora uruchamia funkcję aktywatora kontekstowego określoną w polu calendar.eventOpenTrigger w manifestu dodatku.

Musisz zaimplementować funkcję o nazwie znajdującą się 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 aktywatora może korzystać z informacji zawartych w tym obiekcie zdarzenia do określenia sposobu tworzenia kart dodatkowych lub kontrolowania działania dodatku. Obiekty zdarzeń są też tworzone i przekazywane do funkcji homepageTrigger po pierwszym otwarciu dodatku oraz gdy użytkownik kliknie lub wybierze widżety interaktywne.

Pełną strukturę obiektów zdarzeń opisano w sekcji Obiekty Event. Gdy Kalendarz jest aplikacją hostującą dodatek, obiekty reguły kontekstowej i obiekty interakcji z widżetami zawierają pole obiektu wydarzenia Kalendarza, które zawiera informacje o kliencie specyficzne dla Kalendarza.

Aktualizowanie wydarzeń w Kalendarzu

Oprócz zdarzeń kontekstowych calendar.eventOpenTrigger uruchamianych, gdy użytkownik otwiera wydarzenie w Kalendarzu do edycji, możesz też zdefiniować element calendar.eventUpdateTrigger, który uruchamia się, 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 jednego uczestnika.
  • Usuwa co najmniej jednego uczestnika.
  • Dodaje inne rozwiązanie do obsługi rozmów wideo lub przełącza się na nie.

Po uruchomieniu ten aktywator wykonuje funkcję aktywatora określoną w polu manifestu calendar.eventUpdateTrigger. Funkcja jest wykonywana przed zapisaniem edycji wydarzenia 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 wydarzeń z Kalendarza z systemem innej firmy, np. systemem do obsługi rozmów wideo połączonym z Kalendarzem Google;

Jeśli dodatek jest potrzebny do wprowadzania zmian w danych wydarzenia w Kalendarzu (na przykład na liście uczestników), w polu manifestu dodatku calendar.currentEventAccess musisz ustawić wartość 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 konferencyjne reprezentują opcje rozmów wideo innych firm, 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 trzeba tworzyć interfejsu dla tego typu rozszerzeń. Dodane rozwiązania pojawiają się po prostu jako opcje w menu interfejsu wydarzeń w Kalendarzu Google.