Action obiektów umożliwia tworzenie interaktywnych
w dodatkach do Google Workspace. Definiują
co się dzieje, gdy użytkownik wchodzi w interakcję z widżetem (np. przyciskiem) w
w interfejsie dodatku.
Akcja jest dołączona do danego widżetu za pomocą tagu funkcji obsługi widżetów, który definiuje również warunek wyzwalający działanie. Po uruchomieniu działanie powoduje wykonanie wyznaczonego funkcji wywołania zwrotnego. Funkcja wywołania zwrotnego jest przekazywana w obiekt zdarzenia przenoszący informacje o interakcjach użytkownika po stronie klienta. Musisz zaimplementować wywołania zwrotnego i zwracania konkretnego obiektu odpowiedzi.
Na przykład załóżmy, że chcesz mieć przycisk, który pozwala utworzyć i wyświetlić nową kartę
kliknięto. W tym celu musisz utworzyć nowy widżet przycisku i użyć widżetu przycisku
funkcja obsługi
setOnClickAction(action)
aby ustawić tworzenie kart Action.
Zdefiniowany przez Ciebie Action określa Apps Script
funkcja wywołania zwrotnego, która jest wykonywana po kliknięciu przycisku. W tym przypadku
zaimplementuj funkcję wywołania zwrotnego, by utworzyć odpowiednią kartę i zwrócić
ActionResponse
obiektu. Obiekt odpowiedzi informuje dodatek o konieczności wyświetlenia karty wywołania zwrotnego
funkcji.
Na tej stronie opisujemy działania specyficzne dla Gmaila, które można uwzględnić w Google Analytics.
Interakcje w Gmailu
Dodatki do Google Workspace, które rozszerzają możliwości Gmaila, mogą obejmować dodatkowe działanie widżetu specyficzne dla Gmaila do tworzenia wersji roboczych wiadomości. Ten działanie wymaga powiązanego działania funkcja wywołania zwrotnego zwróci 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 korzystać z tych działań widżetu i obiektów odpowiedzi, dodatek musi
zastosuj
https://www.googleapis.com/auth/gmail.addons.current.action.compose
scope w pliku manifestu.
Utwórz wiadomość
Dodatek do Google Workspace, który rozszerza możliwości Gmaila, może
zdefiniować widżet, który po interakcji będzie generować wersje robocze wiadomości w Gmailu;
(nowych wiadomości lub odpowiedzi). W tym celu musisz powiązać regułę
z funkcją wywołania zwrotnego, która zwraca
ComposeActionResponse
obiektu. Gdy funkcja wywołania zwrotnego dobiegnie końca, Gmail użyje tego
obiektu odpowiedzi, aby otworzyć i wypełnić okno tworzenia wersji roboczej.
Więcej informacji i przykład znajdziesz w materiałach na temat Tworzenie wersji roboczych wiadomości