Los objetos Action te permiten compilar imágenes
comportamiento en los complementos de Google Workspace. Ellos definen
qué 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 a través de un Función de controlador del widget, que también define la condición que activa la acción. Cuando se activa, ejecuta una acción designada función de devolución de llamada. La función de devolución de llamada recibe un objeto de evento que lleve información sobre las interacciones del usuario con el cliente. Debes implementar el función de devolución de llamada y que devuelva un objeto de respuesta específico.
Por ejemplo, supongamos que quieres un botón que cree y muestre una nueva tarjeta cuando
se hizo clic. Para ello, debes crear un nuevo widget de botón y usar el widget de botón.
función del controlador
setOnClickAction(action)
para configurar un Action de creación de tarjetas. El
Action que defines especifica una secuencia de comandos de Apps Script.
función de devolución de llamada que se ejecuta cuando se hace clic en el botón. En este caso,
implementar la función de devolución de llamada para crear la tarjeta que deseas y mostrar un
ActionResponse
. El objeto de respuesta le indica al complemento que muestre la tarjeta con la devolución de llamada
función compilada.
En esta página, se describen las acciones de widgets específicos de Gmail que puedes incluir en tu complemento.
Interacciones con Gmail
Los complementos de Google Workspace que extienden Gmail pueden incluir lo siguiente: una acción adicional de widget específico de Gmail para redactar borradores de mensajes. Esta acción requiere la acción asociada función de devolución de llamada para mostrar un objeto de respuesta especializado:
| Acción realizada | La función de devolución de llamada debería mostrar |
|---|---|
| Cómo redactar borradores de mensajes | ComposeActionResponse |
Para usar estas acciones de widget y objetos de respuesta, el complemento debe
incluyen el
https://www.googleapis.com/auth/gmail.addons.current.action.compose
scope en su manifiesto.
Escribe un mensaje
Un complemento de Google Workspace que extiende Gmail puede
definir un widget que, cuando se interactúa con, genera borradores de mensajes en Gmail
(respuestas o mensajes nuevos). Para ello, debes asociar los recursos
con una función de devolución de llamada que muestre un
ComposeActionResponse
. Cuando la función de devolución de llamada termine de ejecutarse, Gmail usará esta
un objeto de respuesta para abrir y propagar un borrador de una ventana de redacción.
Para obtener más detalles y un ejemplo, consulta Redactar borradores de mensajes