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 lado 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 nuevo widget de botón y usar la función de controlador del widget de botón setOnClickAction(action) para establecer un Action de creación de tarjetas. El objeto 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 devolver 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 de widgets específicas de Gmail que puedes incluir en tu complemento.
Interacciones en Gmail
Los complementos de Google Workspace que extienden Gmail pueden incluir una acción de widget adicional 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 devuelva un objeto de respuesta especializado:
| Acción intentada | La función de devolución de llamada debe devolver |
|---|---|
| Redactar mensajes en borrador | ComposeActionResponse |
Para usar estas acciones y objetos de respuesta de widgets, 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 borradores de mensajes en Gmail (ya sean mensajes nuevos o respuestas). Para ello,asocia 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 completar una ventana de redacción de borrador.
Para obtener más detalles y un ejemplo, consulta Cómo redactar mensajes de borrador.