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 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 deseas un botón que compile y muestre una tarjeta nueva cuando se haga clic en ella. Para ello, debes crear un widget de botón nuevo y usar la función de controlador de widget de botón setOnClickAction(action) para 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, implementas 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 compiló la función de devolución de llamada.
En esta página, se describen las acciones del 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 especializada:
| Acción que se intentó | La función de devolución de llamada debería mostrar |
|---|---|
| Cómo redactar 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 extienda Gmail puede definir un widget que, cuando se interactúe con él, genere mensajes en borrador 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 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 en borrador.
Para obtener más detalles y un ejemplo, consulta Cómo redactar mensajes en borrador.