Los objetos Action te permiten crear un comportamiento interactivo
en los complementos de Google Workspace. Definen lo que sucede cuando un usuario interactúa con un widget (por ejemplo, un botón) en la IU del complemento.
Una acción se adjunta a un widget determinado mediante una función de controlador de widgets, que también define la condición que activa la acción. Cuando se activa, la acción ejecuta una función de devolución de llamada designada . A la función de devolución de llamada se le pasa un objeto de evento que contiene información sobre las interacciones del usuario del cliente. Debes implementar la función de devolución de llamada y hacer que muestre un objeto de respuesta específico.
Por ejemplo, supongamos que quieres un botón que cree y muestre una tarjeta nueva cuando se haga clic en él. Para ello, debes crear un widget de botón nuevo y usar la función de controlador de widgets de botón
setOnClickAction(action)
para configurar una Action de creación de tarjetas. La
Action que definas especifica una función de devolución de llamada de Apps Script
que se ejecuta cuando se hace clic en el botón. En este caso, implementas la función de devolución de llamada para crear la tarjeta que deseas y mostrar un
ActionResponse
objeto. El objeto de respuesta le indica al complemento que muestre la tarjeta que creó la función de devolución de llamada.
En esta página, se describen las acciones de widgets específicas de Gmail que puedes incluir en tu complemento.
Interacciones con Gmail
Los complementos de Google Workspace que extienden Gmail pueden incluir una acción de widget adicional específica de Gmail para redactar mensajes en borrador. Esta acción requiere que la función de devolución de llamada de acción asociada muestre un objeto de respuesta especializado:
| Acción intentada | La función de devolución de llamada debería mostrar |
|---|---|
| Redacta mensajes en borrador | ComposeActionResponse |
Para usar estas acciones de widgets y objetos de respuesta, el
complemento de Google Workspace debe incluir el
https://www.googleapis.com/auth/gmail.addons.current.action.compose
alcance en su
manifiesto.
Escribe un mensaje
Los complementos que extienden Gmail pueden definir un widget que, cuando se interactúa con él, genera mensajes en borrador en Gmail (ya sean mensajes nuevos o respuestas). Para ello,ys
asocia el widget de activación con una función de devolución de llamada que muestre un
ComposeActionResponse
objeto. Cuando la función de devolución de llamada termina de ejecutarse, Gmail usa este objeto de respuesta para abrir y completar una ventana de redacción de borrador.
Para obtener más detalles y un ejemplo, consulta Redacta mensajes en borrador.