Dodatki do Google Workspace wyświetlają informacje i ustawienia użytkownika na pasku bocznym interfejsu aplikacji hosta. Dodatek składa się z głównego paska narzędzi identyfikujących oraz co najmniej jednej karty.
Każda karta reprezentuje konkretną „stronę” interfejsu dodatku, a przejście do nowej karty zwykle polega na utworzeniu tej karty i umieszczeniu jej na wewnętrznym stosie kart. Możesz zdefiniować przepływy nawigacji między kartami, aby zapewnić użytkownikom bogate interakcje.
Karty mogą być niekontekstowe lub kontekstowe. Karty kontekstowe są wyświetlane użytkownikowi, gdy aplikacja hostująca znajduje się w określonym kontekście. Na przykład podczas otwierania wiadomości w Gmailu lub wydarzenia w Kalendarzu. Karty niekontekstowe (np. strony główne) są wyświetlane użytkownikowi poza konkretnym kontekstem hosta. Na przykład gdy użytkownik przegląda skrzynkę odbiorczą Gmaila, główny folder na Dysku lub Kalendarz.
Dodatki do Google Workspace utworzone w Apps Script korzystają z usługi kart, aby tworzyć interfejsy użytkownika z kart. Dodatki utworzone w innych językach muszą zwracać prawidłowo sformatowany kod JSON, aby interfejs renderował się jako karty.
Każda karta składa się z nagłówka i co najmniej 1 sekcji. Każda sekcja składa się z zestawu widżetów. Widżety wyświetlają informacje dla użytkownika lub udostępniają elementy sterujące, takie jak przyciski.
Interfejsy oparte na kartach mają te zalety:
- Do tworzenia interfejsów opartych na kartach nie jest wymagana znajomość języków HTML ani CSS.
- Karty i widżety są automatycznie stylizowane tak, aby dobrze współpracowały z aplikacjami Google Workspace, które rozszerzają.
Interfejsy oparte na kartach działają zarówno na komputerach, jak i na urządzeniach mobilnych, ale wystarczy zdefiniować je tylko raz.
Tworzenie interfejsów opartych na kartach
Podczas tworzenia dodatków opartych na kartach ważne jest, aby zrozumieć pewne koncepcje i wzorce projektowe. W tych przewodnikach znajdziesz informacje potrzebne do tworzenia skutecznych dodatków opartych na kartach:
- Karty
- Strony główne
- Widżety
- Działania
- Obiekty zdarzeń
- Tworzenie kart
- Tworzenie kart interaktywnych
- Przechodzenie między kartami
- Korzystanie z działań uniwersalnych
- Dodawanie autouzupełniania do pól tekstowych
- Uzyskiwanie dostępu do ustawień regionalnych i stref czasowych użytkowników
- Łączenie z usługami innych firm
- Style guide
- Sprawdzone metody
Podczas tworzenia kart i wdrażania zachowania interfejsu odwołuj się do tych stron. Podczas wdrażania dodatku mogą Ci się przydać te dodatkowe przykłady:
Szybki start z dodatkiem do Google Workspace „Cats”
Ten przykładowy dodatek pokazuje prosty interfejs dodatku do Google Workspace z wieloma stronami i stronami głównymi.
Dodatek do Google Workspace: „Translate”
Ten przykładowy dodatek to dodatek do Google Workspace, który umożliwia użytkownikom tłumaczenie tekstu w Dokumentach, Arkuszach i Prezentacjach.
Dodatek do Google Workspace: „Lista zespołów”
Ten przykładowy dodatek pokazuje bardziej złożony przykład dodatku do Google Workspace, który wyświetla informacje o użytkownikach dotyczące odbiorców wiadomości w Gmailu, edytujących pliki na Dysku lub uczestników wydarzeń w Kalendarzu. Tego dodatku możesz używać tylko w domenie, ponieważ do pobierania informacji o użytkownikach korzysta on z Directory API.