Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Los activadores de Apps Script hacen que se ejecute una función de secuencia de comandos especificada (la función de activación) cada vez que se produce un evento especificado. Solo ciertos eventos pueden activar los activadores, y cada aplicación de Google Workspace admite un conjunto diferente de eventos.
Cuando se activa un disparador, se crea un objeto de evento. Esta estructura JSON contiene detalles sobre el evento que ocurrió. La información de la estructura del objeto de evento se organiza de manera diferente según el tipo de activador.
Una vez que se crea el objeto de evento, Apps Script lo pasa como parámetro a la función de activación. La función de activación es una función de devolución de llamada que debes implementar por tu cuenta para realizar las acciones adecuadas en respuesta al evento. Por ejemplo, en un complemento de Google Workspace que extiende Gmail, puedes definir un activador que cree una nueva interfaz de tarjeta cuando el usuario abra un hilo de mensajes. En este caso, implementarás una función de devolución de llamada contextual para crear las tarjetas que componen la nueva IU con los datos que se pasan en el objeto de evento.
En esta página, se proporcionan lineamientos para usar activadores en proyectos de complementos de Google Workspace.
Activadores de manifiesto
A diferencia de los complementos del Editor, los complementos de Google Workspace actualmente no pueden usar activadores simples de Apps Script. En cambio, usan activadores diseñados específicamente para los complementos de Google Workspace: los activadores de manifiesto.
Los activadores del manifiesto se definen por completo en el manifiesto del complemento de Google Workspace. Estos son algunos ejemplos de activadores de manifiesto:
Activadores de la página principal que compilan y muestran la página principal del complemento
Activadores de apertura de eventos de calendario que muestran una tarjeta nueva o realizan otras acciones cuando se abre un evento de calendario.
Activadores de Calendar eventUpdate que muestran una tarjeta nueva o realizan otras acciones cuando un usuario edita y guarda un evento de Calendario
Activadores de Drive onItemsSelected que muestran una tarjeta nueva o realizan otras acciones cuando un usuario selecciona uno o más archivos o carpetas en Drive
Activadores de redacción de Gmail que muestran una tarjeta de complemento cuando el usuario abre el complemento en la ventana de redacción de Gmail
Activadores contextuales de Gmail que muestran una tarjeta nueva o realizan otras acciones cuando el usuario abre un mensaje de Gmail
Editor onFileScopeGranted triggers que muestran una tarjeta nueva cuando los usuarios otorgan autorización para el permiso de OAuth drive.file en el documento actual del Editor.
En la lista anterior, solo los activadores de la página principal son no contextuales; el resto son activadores contextuales. Consulta Manifiesto para obtener más información sobre las definiciones de activadores de manifiesto.
Además de los activadores del manifiesto, los complementos de Google Workspace también pueden usar los activadores instalables de Apps Script.
Restricciones
Los activadores de manifiesto tienen ciertas restricciones de uso.
Estos activadores solo se usan en proyectos de complementos de Google Workspace y no tienen ningún propósito en otras aplicaciones.
Como se definen en el manifiesto del complemento y no en su código, no puedes usar el servicio Script de Apps Script para crear o modificar estos activadores.
Actualmente, los activadores contextuales de Gmail solo pueden tener un criterio de unconditional.
Esto significa que los activadores contextuales se activan para cada mensaje de correo electrónico, independientemente del contenido.
Cada complemento solo puede tener un activador de cada tipo por usuario y por documento.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-31 (UTC)"],[[["\u003cp\u003eApps Script triggers execute a specific function when a defined event occurs within a Google Workspace application.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Workspace add-ons utilize manifest triggers, defined in the add-on's manifest, to respond to events like opening a document or composing an email.\u003c/p\u003e\n"],["\u003cp\u003eManifest triggers can be contextual, reacting to specific user actions within a document or application, or non-contextual, like those that build the add-on's homepage.\u003c/p\u003e\n"],["\u003cp\u003eWhile manifest triggers offer event-driven functionality, they have limitations, including restrictions on their use and creation methods.\u003c/p\u003e\n"]]],["Apps Script triggers initiate a script function when specific events occur, creating an event object with event details. This object is then passed to a user-implemented trigger function, enabling actions based on the event. Google Workspace add-ons use manifest triggers, defined in the add-on's manifest, to trigger actions like displaying cards on homepage, when opening/updating Calendar events, selecting Drive items, or opening a message in Gmail. Contextual triggers and installable triggers are also supported but with some restrictions.\n"],null,["# Triggers for Google Workspace add-ons\n\n[Apps Script triggers](/apps-script/guides/triggers) cause a specified script\nfunction (the *trigger function*) to execute whenever a specified event\noccurs. Only certain events can cause triggers to fire, and each\nGoogle Workspace application supports a different set of events.\n\nWhen a trigger fires, an *event object* is created. This JSON structure\ncontains details about the event that occurred. The information in the event\nobject structure is organized differently based on the trigger type.\n\nOnce the event object is created, Apps Script passes it as a parameter to the\ntrigger function. The trigger function is a callback function that you must\nimplement yourself, to take whatever actions are appropriate to respond to the\nevent. For example, in a\nGoogle Workspace add-on that extends Gmail, you can\ndefine a trigger that creates a new card interface when the user opens a message\nthread. In this case, you implement a contextual callback function to create\nthe cards making up the new UI using the data passed in the\n[event object](/workspace/add-ons/concepts/event-objects).\n\nThis page provides guidelines on using triggers in\nGoogle Workspace\nadd-on projects.\n\nManifest triggers\n-----------------\n\nUnlike Editor add-ons, Google Workspace add-ons\ncurrently can't use Apps Script [simple triggers](/apps-script/guides/triggers)\nInstead, they use triggers designed specifically for\nGoogle Workspace add-ons: *manifest triggers*.\n\nManifest triggers are defined completely in the\nGoogle Workspace add-on's\n[manifest](/workspace/add-ons/concepts/workspace-manifests). Examples of manifest triggers include the\nfollowing:\n\n- **Homepage triggers** that build and display the add-on homepage.\n- **Calendar eventOpen triggers** that display a new card or take other actions when a Calendar event is opened.\n- **Calendar eventUpdate triggers** that display a new card or take other actions when a user edits and saves a Calendar event.\n- **Drive onItemsSelected triggers** that display a new card or take other actions when a user selects one or more files or folders in Drive.\n- **Gmail compose triggers** that display an add-on card when the user opens the add-on in the Gmail compose window.\n- **Gmail contextual triggers** that display a new card or take other actions when the user opens a Gmail message.\n- **Editor onFileScopeGranted triggers** that display a new card when users grant authorization for the `drive.file` OAuth scope in the current Editor document.\n\nIn the above list, only homepage triggers are non-contextual; the rest are\ncontextual triggers. See [Manifest](/workspace/add-ons/concepts/workspace-manifests)\nfor more information about manifest trigger definitions.\n\nIn addition to manifest triggers, Google Workspace\nadd-ons can also use Apps Script\n[installable triggers](/apps-script/guides/triggers/installable).\n\n### Restrictions\n\nManifest triggers have certain restrictions to their use.\n\n- These triggers are only used in Google Workspace add-on projects; they have no purpose in any other application.\n- Since they are defined in the add-on manifest and not in its code, you can't use the Apps Script [`Script`](/apps-script/reference/script) service to create or modify these triggers.\n- Gmail contextual triggers currently can only have an `unconditional` criteria. This means contextual triggers fire for every email message, regardless of content.\n- Each add-on can only have one trigger of each type, per user, per document."]]
