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 con 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 que un botón cree y muestre una tarjeta nueva cuando se hace clic en él. Para ello, debes crear un nuevo widget de botón y usar la función de controlador de widget de botón setOnClickAction(action) para configurar un Action de creació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, debes implementar 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 widgets 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 de 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 | La función de devolución de llamada debe mostrar |
|---|---|
| Cómo redactar mensajes en borrador | ComposeActionResponse |
Para usar estas acciones de widgets y objetos de respuesta, el complemento debe incluir el alcance https://www.googleapis.com/auth/gmail.addons.current.action.compose en su manifiesto.
Escribe un mensaje
Un complemento de Google Workspace que extiende Gmail puede definir un widget que, cuando se interactúa con él, genera borradores de mensajes en Gmail (ya sean mensajes nuevos o respuestas). Para ello, debes asociar el widget de activación con una función de devolución de llamada que muestre un objeto ComposeActionResponse. Cuando finaliza la ejecución de la función de devolución de llamada, Gmail usa este objeto de respuesta para abrir y propagar una ventana de redacción de borradores.
Para obtener más detalles y un ejemplo, consulta Cómo redactar mensajes de borrador.