Obiekty Action umożliwiają tworzenie interaktywnych funkcji w dodatkach do Google Workspace. Określają, co się dzieje, gdy użytkownik wchodzi w interakcję z widżetem (np. przyciskiem) w interfejsie dodatku.
Działanie jest dołączane do danego widżetu za pomocą funkcji obsługi widżetu, która określa też warunek wywołujący działanie. Po wywołaniu działania wykonuje ono wyznaczone wywołanie zwrotne. Funkcja wywołania zwrotnego otrzymuje obiekt zdarzenia, który zawiera informacje o interakcjach użytkownika po stronie klienta. Musisz zaimplementować funkcję wywołania zwrotnego i sprawić, aby zwracała określony obiekt odpowiedzi.
Załóżmy na przykład, że chcesz utworzyć przycisk, który po kliknięciu tworzy i wyświetla nową kartę. W tym celu musisz utworzyć nowy widżet przycisku i użyć funkcji obsługi widżetu przycisku setOnClickAction(action), aby ustawić Action tworzenia karty. Zdefiniowany przez Ciebie element
Action określa wywołanie zwrotne Apps Script, które jest wykonywane po kliknięciu przycisku. W takim przypadku implementujesz wywołanie zwrotne, aby utworzyć żądaną kartę, i zwracasz obiekt ActionResponse. Obiekt odpowiedzi informuje dodatek, że ma wyświetlić kartę utworzoną przez funkcję wywołania zwrotnego.
Na tej stronie opisujemy działania widżetów specyficzne dla Gmaila, które możesz uwzględnić w dodatku.
Interakcje w Gmailu
Dodatki do Google Workspace, które rozszerzają Gmaila, mogą zawierać dodatkowe działanie widżetu specyficzne dla Gmaila, które umożliwia tworzenie wersji roboczych wiadomości. To działanie wymaga, aby powiązana z nim funkcja wywołania zwrotnego zwracała specjalny obiekt odpowiedzi:
| Podjęte działanie | Funkcja wywołania zwrotnego powinna zwracać |
|---|---|
| Tworzenie wersji roboczych wiadomości | ComposeActionResponse |
Aby korzystać z tych działań widżetu i obiektów odpowiedzi, dodatek Google Workspace musi zawierać w manifeście https://www.googleapis.com/auth/gmail.addons.current.action.compose
zakres.
Tworzenie wiadomości
Dodatki rozszerzające Gmaila mogą definiować widżet, który po interakcji generuje w Gmailu wersje robocze wiadomości (nowe wiadomości lub odpowiedzi). Aby to zrobić,ys przypisz do widżetu wyzwalającego funkcję wywołania zwrotnego, która zwraca obiekt ComposeActionResponse. Gdy funkcja wywołania zwrotnego zakończy działanie, Gmail użyje tego obiektu odpowiedzi, aby otworzyć i wypełnić okno tworzenia wiadomości w wersji roboczej.
Więcej informacji i przykład znajdziesz w artykule Tworzenie wersji roboczych wiadomości.