Los objetos Action te permiten compilar 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 widget, 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. La función de devolución de llamada recibe un objeto de evento que lleva información sobre las interacciones del cliente del usuario. 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 compile y muestre una tarjeta nueva cuando hagas clic en ella. Para ello, debes crear un widget de botón nuevo y usar la función del controlador de widgets de botón setOnClickAction(action) a fin de configurar un Action de compilación de tarjetas. El Action que defines 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, implementa la función de devolución de llamada para compilar la tarjeta que deseas y mostrar un objeto ActionResponse. 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 widget específicas de Gmail que puedes incluir en tu complemento.
Interacciones de Gmail
Los complementos de Google Workspace que extienden Gmail pueden incluir una acción adicional de widget específica de Gmail para redactar mensajes en borrador. Esta acción requiere que la función de devolución de llamada de la acción asociada muestre un objeto de respuesta especializado:
| Intento de acción | Se debería mostrar la función de devolución de llamada |
|---|---|
| Redacte mensajes en borrador | ComposeActionResponse |
Para usar estas acciones de widget y objetos de respuesta, el complemento debe incluir el alcance https://www.googleapis.com/auth/gmail.addons.current.action.compose en su manifiesto.
Escribir un mensaje
Un complemento de Google Workspace que extiende Gmail puede definir un widget que, cuando se interactúa con este, genera borradores de mensajes en Gmail (ya sean mensajes nuevos o respuestas). Para hacerlo, debes asociar el widget de activación con una función de devolución de llamada que muestre un objeto ComposeActionResponse. Cuando la función de devolución de llamada termina de ejecutarse, Gmail usa este objeto de respuesta para abrir y propagar una ventana de redacción de borrador.
Para obtener más detalles y un ejemplo, consulta Cómo redactar mensajes en borrador.