Tworzenie interfejsów Kalendarza Google

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

Podczas tworzenia interfejsu dodatku do Kalendarza Google możesz udostępnić stronę główną. Możesz używać tej samej strony głównej w przypadku wielu hostów lub zaprojektować specjalną stronę dla Kalendarza Google.

Dodatek może też definiować interfejs, który pojawia się, gdy użytkownik ma otwarte wydarzenie w Kalendarzu.

Otwieranie interfejsu dodatku

W zależności od sposobu otwarcia dodatek Google Workspace może definiować 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ę strony głównej do Kalendarza, która ma być wyświetlana. Jeśli nie zdefiniowano funkcji calendar.homepageTrigger, wyświetli się ogólna karta strony głównej.
• Jeśli użytkownik otworzy wydarzenie w Kalendarzu, a następnie kliknie ikonę dodatku lub dodatek będzie otwarty, gdy użytkownik otworzy wydarzenie, dodatek wykona odpowiednią funkcję eventOpenTrigger (jeśli jest dostępna). Ta funkcja tworzy interfejs wydarzenia w Kalendarzu dodatku i przekazuje go do Kalendarza Google w celu wyświetlenia.
• Jeśli dodatek definiuje funkcję eventAttachmentTrigger, podczas edytowania wydarzenia w Kalendarzu użytkownik zobaczy go jako dostawcę załączników, gdy kliknie Dodaj załącznik. Gdy dodatek zostanie wybrany, funkcja eventAttachmentTrigger utworzy interfejs wyboru załącznika dodatku i zwróci go do Kalendarza Google w celu wyświetlenia.

Tworzenie interfejsu dodatku do Kalendarza

Aby rozszerzyć Kalendarz Google za pomocą dodatku do Google Workspace:

1. Zdecyduj, czy chcesz, aby dodatek miał stronę główną przeznaczoną specjalnie dla Kalendarza. Zdecyduj też, czy chcesz udostępniać niestandardowy interfejs, gdy użytkownik edytuje wydarzenia w Kalendarzu.
2. Dodaj odpowiednie pola addOns.common i addOns.calendar do manifestu projektu skryptu dodatku, w tym wymagane zakresy.
3. Jeśli udostępniasz stronę główną Kalendarza, zaimplementuj funkcję calendar.homepageTrigger, aby utworzyć ten interfejs. Możesz też użyć interfejsu common.homepageTrigger w przypadku wielu hostów Google Workspace.
4. Jeśli udostępniasz interfejs wydarzenia w Kalendarzu, musisz zaimplementować funkcję calendar.eventOpenTrigger, aby go utworzyć. Szczegółowe informacje znajdziesz w artykule Rozszerzanie interfejsu wydarzenia w Kalendarzu.
5. Zaimplementuj powiązane funkcje wywołania zwrotnego potrzebne do reagowania na interakcje użytkownika z interfejsem, 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 manifeście dodatku znajduje się pole addOns.calendar.

Możesz też dodać calendar.homepageTrigger do pliku manifestu dodatku, aby udostępnić stronę główną przeznaczoną dla Kalendarza.

W obu przypadkach musisz podać nazwę funkcji wywołującej stronę główną w projekcie skryptu dodatku. Ta funkcja jest wywoływana automatycznie w razie potrzeby, aby 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 składają się na stronę główną. Funkcja wywołująca na stronie głównej otrzymuje jako parametr obiekt zdarzenia, który zawiera ogólne informacje, takie jak platforma klienta. Dane obiektu zdarzenia możesz wykorzystać do dostosowania konstrukcji strony głównej.

Rozszerzanie interfejsu wydarzenia w Kalendarzu

Kalendarz Google korzysta z wyzwalacza kontekstowego, aby określić, jaki interfejs (jeśli w ogóle) ma być wyświetlany, gdy użytkownik edytuje wydarzenie w Kalendarzu. Gdy aktywator zostanie uruchomiony, wykona funkcję aktywatora kontekstowego określoną w polu calendar.eventOpenTrigger w manifeście 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 Kalendarz będzie wyświetlać, gdy użytkownik otworzy wydarzenie.

Obiekty zdarzeń

Gdy użytkownik otworzy wydarzenie w Kalendarzu, zostanie utworzony obiekt wydarzenia i przekazany do funkcji aktywatora kontekstowego calendar.eventOpenTrigger. Funkcja wywołująca może używać informacji z tego obiektu zdarzenia do określania sposobu tworzenia kart dodatku lub kontrolowania jego działania. Obiekty zdarzeń są też tworzone i przekazywane do funkcjihomepageTrigger, gdy dodatek jest otwierany po raz pierwszy oraz gdy użytkownik klika lub wybiera interaktywne widżety.

Pełna struktura obiektów zdarzeń jest opisana w sekcji Obiekty zdarzeń. Gdy Kalendarz jest aplikacją hostującą dodatek, obiekty zdarzeń wyzwalacza kontekstowego i interakcji z widżetem zawierają pole obiektu wydarzenia w Kalendarzu, które zawiera informacje o kliencie specyficzne dla Kalendarza.

Aktualizowanie wydarzeń w Kalendarzu

Oprócz zdarzenia kontekstowego calendar.eventOpenTrigger wywoływanego, gdy użytkownik otwiera wydarzenie w Kalendarzu w celu edycji, możesz też zdefiniować zdarzenie calendar.eventUpdateTrigger wywoływane, gdy użytkownik zaktualizuje i zapisze wydarzenie w Kalendarzu. Ten wyzwalacz jest aktywowany 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.

Gdy ta reguła zostanie uruchomiona, wykona funkcję reguły określoną w polu manifestu calendar.eventUpdateTrigger. Funkcja jest wykonywana przed zapisaniem zmian w wydarzeniu w Kalendarzu.

Symbol calendar.eventUpdateTrigger jest zwykle używany do co najmniej jednego z tych celów:

• Aktualizowanie interfejsu wydarzenia w Kalendarzu dodatku w odpowiedzi na zmiany wprowadzone przez użytkownika w wydarzeniu w Kalendarzu.
• synchronizować dane wydarzeń w Kalendarzu z systemem innej firmy, np. z systemem konferencyjnym połączonym z Kalendarzem Google;

Jeśli dodatek ma wprowadzać zmiany w danych wydarzenia w Kalendarzu (np. w liście uczestników), musisz ustawić pole manifestu dodatku calendar.currentEventAccess na WRITE lub READ_WRITE. Wymaga to również, aby dodatek miał https://www.googleapis.com/auth/calendar.addons.current.event.write zakres.

Dodawanie rozwiązań do obsługi rozmów wideo

dodatkach do Google Workspace.

Rozwiązania do rozmów wideo to opcje rozmów wideo innych firm, które użytkownicy mogą dołączać do wydarzeń w Kalendarzu Google. W dokumentacji Omówienie zewnętrznych usług konferencyjnych znajdziesz szczegółowe informacje o tym, jak utworzyć dodatek, który dodaje nowe rozwiązania konferencyjne. Nie musisz tworzyć interfejsu do tego typu rozszerzenia. Dodane rozwiązania po prostu pojawiają się jako opcje w menu w interfejsie wydarzenia w Kalendarzu Google.