Tworzenie interfejsów Kalendarza Google

Dodatki do Google Workspace zapewniają do interfejsów, gdy użytkownik wyświetla lub edytuje kalendarze i wydarzenia z Kalendarza. Dzięki temu możesz przekazać użytkownikowi dodatkowe istotne informacje, zadań i łączenia systemów innych firm z Kalendarzem Google.

Tworząc interfejs dodatku do Kalendarza Google, możesz podać stronie głównej. Możesz użyć tego samego stronę główną dla wielu hostów lub zaprojektuj konkretną stronę dla Kalendarza Google.

Dodatek może też określać interfejs, który pojawia się, gdy użytkownik otwarte 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 zostanie uruchomiony odpowiadający mu element: calendar.homepageTrigger (jeśli istnieje). Ta funkcja tworzy i zwraca kartę strony głównej do Kalendarza. Jeśli nie calendar.homepageTrigger , zamiast niej wyświetla się standardowa karta strony głównej.
• jeśli użytkownik otworzy wydarzenie w Kalendarzu, a następnie kliknie ikonę dodatku; dodatek jest otwierany, gdy użytkownik otworzy wydarzenie, wykonuje odpowiednie polecenie eventOpenTrigger (jeśli istnieje). Ta funkcja tworzy wydarzenie w Kalendarzu dodatku i wraca do Kalendarza Google.
• Jeśli dodatek definiuje funkcję eventAttachmentTrigger, dodatek jest wyświetlany jako dostawca załączników, gdy użytkownik kliknie Dodaj załącznik podczas edytowania wydarzenia w Kalendarzu. Po wybraniu dodatku funkcja eventAttachmentTrigger tworzy załącznik dodatku i zwraca go do Kalendarza Google.

Tworzenie interfejsu Kalendarza dodatku

Kalendarz Google można rozszerzyć o aby wykonać te czynności:

1. Zdecyduj, czy chcesz, aby dodatek miał zastosowanie tylko do Kalendarza. stronie głównej. Zdecyduj też, czy chcesz udostępniać użytkownikom niestandardowy interfejs, gdy edytowanie wydarzeń w Kalendarzu.
2. Dodaj odpowiednie addOns.common i addOns.calendar w manifeście projektu skryptu dodatkowego, w tym wszystkie wymagane zakresy.
3. Jeśli podajesz adres kalendarza strona główna, zastosuj calendar.homepageTrigger. do tworzenia tego interfejsu. Możesz też użyć atrybutu common.homepageTrigger dla wielu hostów Google Workspace.
4. Jeśli udostępniasz interfejs wydarzenia w Kalendarzu, musisz zaimplementować tag calendar.eventOpenTrigger do tworzenia tego interfejsu. Zobacz Rozszerzanie interfejsu wydarzeń w Kalendarzu .
5. Zaimplementować powiązane funkcje wywołania zwrotnego niezbędne do reagowania na interakcje z interfejsem, np. kliknięcia przycisków;

Strony główne Kalendarza

Kalendarz Google obsługuje wyświetlanie stron głównych dodatków do Google Workspace. Aby wyświetlać w Kalendarzu Google wspólną stronę główną dodatku, po prostu upewnij się, że znajduje się tam to addOns.calendar w pliku manifestu dodatku.

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

W obu przypadkach musisz w w projekcie skryptu. Funkcja ta jest automatycznie wywoływana w celu utworzenia na stronie głównej Kalendarza Google. Musisz zaimplementować tę funkcję, aby skompilować i zwracają Card lub tablica Card obiekty składające się na stronę główną. Funkcja aktywatora strony głównej jest przekazywana w obiekt zdarzenia jako parametr zawierający ogólne informacje, takie jak platformy. Korzystając z danych obiektu zdarzenia, możesz dostosować konstrukcję stronie głównej.

Rozszerzanie interfejsu wydarzeń w Kalendarzu

Kalendarz Google określa interfejs na podstawie czynników kontekstowych (jeśli takie istnieją), która jest wyświetlana, gdy użytkownik edytuje wydarzenie w Kalendarzu. Kiedy reguła uruchamia funkcję wyzwalacza kontekstowego wskazaną przez calendar.eventOpenTrigger w pliku manifestu dodatku.

Musisz zaimplementować funkcję o nazwie calendar.eventOpenTrigger . Ta funkcja akceptuje obiekt zdarzenia jako i musi zwracać jeden Card lub tablica Obiekty Card, do których Kalendarz ma dostęp wyświetlają się, gdy użytkownik otwiera wydarzenie.

Obiekty zdarzeń

tworzony jest obiekt zdarzenia, przekazano do calendar.eventOpenTrigger. funkcja aktywatora kontekstowego po otwarciu wydarzenie w Kalendarzu. Funkcja aktywatora może używać informacji z tego zdarzenia , aby określić sposób tworzenia kart dodatków lub sterowania dodatkiem. zachowanie użytkownika. Obiekty zdarzeń są również tworzone i przekazywane do homepageTrigger działa po pierwszym uruchomieniu dodatku oraz gdy użytkownik kliknie lub wybierze ten dodatek. interaktywne widżety.

Uwaga: termin „wydarzenie” w „obiekcie zdarzenia” oznacza działanie podjęte przez użytkownika w interfejsie dodatku i powiązanej z nim odpowiedzi, a nie wydarzeniu w Kalendarzu. Aby zachować że rozróżnienie jest jasne, wydarzenia w Kalendarzu są zawsze nazywane „Wydarzenia w kalendarzu” w tej dokumentacji.

Pełną strukturę obiektów zdarzeń opisano w obiekty zdarzeń – Gdy Kalendarz jest aplikacją hostującą dodatek, wyzwalacz kontekstowy i obiekty interakcji z widżetem zawierają Obiekt wydarzenia w kalendarzu z informacjami o kliencie specyficznymi dla Kalendarza.

Aktualizowanie wydarzeń w Kalendarzu

Oprócz reklam kontekstowych calendar.eventOpenTrigger uruchamia się, gdy użytkownik otworzy wydarzenia w Kalendarzu, które chcesz edytować, możesz też zdefiniować calendar.eventUpdateTrigger uruchamiany, gdy użytkownik zaktualizuje i zapisze wydarzenie w Kalendarzu. Tylko ten aktywator uruchamia się, 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 ta reguła wykonuje funkcji aktywującej określonej przez calendar.eventUpdateTrigger pliku manifestu. Funkcja jest wykonywana, zanim edycja wydarzenia w Kalendarzu zostanie zapisane.

calendar.eventUpdateTrigger jest zwykle używany do wykonania jednej lub kilku z tych czynności:

• Aktualizowanie interfejsu wydarzenia w Kalendarzu dodatku w odpowiedzi na zmiany wprowadzone przez użytkowników do wydarzenia w Kalendarzu.
• synchronizować dane wydarzeń w Kalendarzu z systemem innych firm, np. dotyczące rozmów wideo; połączony z Kalendarzem Google.

Jeśli dodatek jest potrzebny do wprowadzenia zmian w danych wydarzenia w Kalendarzu (takich jak jako listę uczestników), musisz ustawić dodatek calendar.currentEventAccess manifestu na wartość WRITE lub READ_WRITE. To także wymaga, aby dodatek miał https://www.googleapis.com/auth/calendar.addons.current.event.write zakres.

Dodawanie rozwiązań do obsługi konferencji

Uwaga: dodawanie rozwiązań konferencyjnych jest przeznaczone tylko dla deweloperów, którzy chcą integrować z Kalendarzem Google własny system konferencyjny innej firmy. Ta funkcja była wcześniej dostępna w wersji beta jako Dodatki do rozmów wideo w Kalendarzu są już dostępne w Dodatki do Google Workspace.

Rozwiązania konferencyjne reprezentują opcje rozmów wideo innych firm, do których użytkownicy mogą dołączać wydarzeniach w Kalendarzu Google. Omówienie rozmów wideo firm zewnętrznych znajdziesz w dokumentacji szczegółowe informacje na temat tworzenia dodatku, który dodaje nowe do prowadzenia rozmów wideo. Nie trzeba tworzyć interfejsu użytkownika dla tego typu rozszerzenie; dodane rozwiązania pojawiają się jako opcje w menu w interfejsie wydarzeń Kalendarza Google.