Obiekty Action umożliwiają tworzenie interaktywnych zachowań w dodatkach do Google Workspace. Określają one, co dzieje się, 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 definiuje też warunek wywołujący działanie. Po wywołaniu działanie wykonuje określone wywołanie zwrotne. Do funkcji wywołania zwrotnego przekazywany jest obiekt zdarzenia zawierający informacje o interakcjach użytkownika po stronie klienta. Musisz zaimplementować funkcję wywołania zwrotnego i skonfigurować ją tak, aby zwracała określony obiekt odpowiedzi.
Załóżmy na przykład, że chcesz mieć przycisk, który po kliknięciu tworzy i wyświetla nową kartę. W tym celu musisz utworzyć nowy widget przycisku i użyć funkcji obsługi widgetu przycisku setOnClickAction(action), aby skonfigurować tworzenie karty Action. Zdefiniowany przez Ciebie parametr Action wskazuje funkcję wywołania zwrotnego Apps Script, która jest wykonywana po kliknięciu przycisku. W tym przypadku możesz zaimplementować funkcję zwrotną, aby utworzyć odpowiednią kartę i zwrócić obiekt ActionResponse. Obiekt odpowiedzi informuje dodatek, aby wyświetlił kartę utworzoną przez funkcję wywołania zwrotnego.
Ta strona zawiera opis działań dotyczących widżetów w Google Gmail, które możesz uwzględnić w swoim dodatku.
Interakcje z Gmailem
Dodatki Google Workspace, które rozszerzają Gmaila, mogą zawierać dodatkową akcję widżetu dotyczącą Gmaila, która umożliwia tworzenie wersji roboczych wiadomości. Ta działania wymaga powiązanej akcji funkcji wywołania zwrotnego zwracającej wyspecjalizowany obiekt odpowiedzi:
| Podejmowane działanie | Wywołanie zwrotne powinno zwrócić |
|---|---|
| Tworzenie wersji roboczych wiadomości | ComposeActionResponse |
Aby korzystać z tych działań widżetu i obiektów odpowiedzi, dodatek musi zawierać w swoim pliku manifestu https://www.googleapis.com/auth/gmail.addons.current.action.compose
zakres.
Tworzenie wiadomości
Dodatek Google Workspace rozszerzający Gmaila może zdefiniować widżet, który po interakcji z użytkownikiem generuje w Gmailu wersje robocze wiadomości (nowe wiadomości lub odpowiedzi). Aby to zrobić, musisz powiązać wywołujący widget z funkcją wywołania zwrotnego, która zwraca obiekt ComposeActionResponse. Po zakończeniu działania funkcji wywołania zwrotnego Gmail używa obiektu odpowiedzi, aby otworzyć okno tworzenia wersji roboczej i je wypełnić.
Więcej informacji i przykład znajdziesz w artykule Tworzenie wersji roboczych wiadomości.