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 funkcjicalendar.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 funkcjaeventAttachmentTrigger
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:
- 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.
- Dodaj odpowiednie pola
addOns.common
iaddOns.calendar
do manifestu projektu skryptu dodatku, wraz ze wszystkimi wymaganymi zakresami. - Jeśli udostępniasz stronę główną Kalendarza, zaimplementuj funkcję
calendar.homepageTrigger
, by utworzyć ten interfejs. Możesz też używać interfejsucommon.homepageTrigger
dla 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ć 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.