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 niecalendar.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 funkcjaeventAttachmentTrigger
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:
- 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.
- Dodaj odpowiednie
addOns.common
iaddOns.calendar
w manifeście projektu skryptu dodatkowego, w tym wszystkie wymagane zakresy. - Jeśli podajesz adres kalendarza
strona główna,
zastosuj
calendar.homepageTrigger
do tworzenia tego interfejsu. Możesz też użyć atrybutucommon.homepageTrigger
dla wielu hostów Google Workspace. - Jeśli udostępniasz interfejs wydarzenia w Kalendarzu, musisz zaimplementować tag
calendar.eventOpenTrigger
do tworzenia tego interfejsu. Zobacz Rozszerzanie interfejsu wydarzeń w Kalendarzu . - 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.
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
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 extension; dodane rozwiązania pojawiają się jako opcje w menu w interfejsie wydarzeń Kalendarza Google.