Obiekty Action pozwalają tworzyć interaktywne zachowanie w dodatkach do Google Workspace. Określają one, co się stanie, gdy użytkownik wejdzie 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. Wywołane działanie powoduje wykonanie określonej funkcji wywołania zwrotnego. Funkcja wywołania zwrotnego przekazuje obiekt zdarzenia zawierający informacje o interakcjach użytkownika po stronie klienta. Musisz wdrożyć funkcję wywołania zwrotnego, która będzie zwracać określony obiekt odpowiedzi.
Załóżmy, że chcesz, aby 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 skonfigurować tworzenie kart Action. Zdefiniowany przez Ciebie element Action określa funkcję wywołania zwrotnego Apps Script wykonywaną po kliknięciu przycisku. W takim przypadku zaimplementujesz funkcję wywołania zwrotnego, aby utworzyć odpowiednią kartę i zwrócić obiekt ActionResponse. Obiekt odpowiedzi informuje dodatek, że ma wyświetlić kartę utworzoną przez funkcję wywołania zwrotnego.
Na tej stronie opisujemy działania związane z widżetami Gmaila, które możesz uwzględnić w swoim dodatku.
Interakcje w Gmailu
Dodatki do Google Workspace, które rozszerzają możliwości Gmaila, mogą zawierać dodatkowe, specyficzne dla Gmaila działanie widżetu, które umożliwia tworzenie wersji roboczych wiadomości. To działanie wymaga powiązanej funkcji wywołania zwrotnego działania, która zwraca wyspecjalizowany obiekt odpowiedzi:
| Podjęto próbę wykonania działania | Funkcja wywołania zwrotnego powinna zwrócić |
|---|---|
| Tworzenie wersji roboczych wiadomości | ComposeActionResponse |
Aby można było użyć tych działań widżetu i obiektów odpowiedzi, dodatek musi zawierać w swoim pliku manifestu parametr https://www.googleapis.com/auth/gmail.addons.current.action.compose
scope.
Utwórz wiadomość
Dodatek do Google Workspace, który rozszerza Gmaila, może zdefiniować widżet, który po interakcji generuje w Gmailu wersje robocze wiadomości (nowe wiadomości lub odpowiedzi). Aby to zrobić, musisz powiązać widżet wywołujący z 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.