Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.
Os acionadores do Apps Script fazem com que uma função de script especificada (a função de acionamento) seja executada sempre que um evento especificado ocorre. Somente alguns eventos podem acionar gatilhos, e cada aplicativo do Google Workspace é compatível com um conjunto diferente de eventos.
Quando um gatilho é acionado, um objeto de evento é criado. Essa estrutura JSON contém detalhes sobre o evento que ocorreu. As informações na estrutura do objeto de evento são organizadas de maneira diferente com base no tipo de gatilho.
Depois que o objeto de evento é criado, o Apps Script o transmite como um parâmetro para a função de acionamento. A função de gatilho é um callback que você precisa implementar para realizar as ações adequadas em resposta ao evento. Por exemplo, em um complemento do Google Workspace que estende o Gmail, é possível definir um gatilho que cria uma nova interface de card quando o usuário abre uma conversa por e-mail. Nesse caso, você implementa uma função de callback contextual para criar os cards que compõem a nova interface usando os dados transmitidos no objeto de evento.
Esta página fornece diretrizes sobre como usar gatilhos em projetos de complementos do Google Workspace.
Gatilhos de manifesto
Ao contrário dos complementos do editor, os complementos do Google Workspace não podem usar acionadores simples do Apps Script no momento. Em vez disso, eles usam acionadores projetados especificamente para complementos do Google Workspace: acionadores de manifesto.
Os gatilhos de manifesto são definidos completamente no manifesto do complemento do Google Workspace. Exemplos de gatilhos de manifesto incluem o seguinte:
Acionadores da página inicial que criam e mostram a página inicial do complemento.
Eventos da agenda que mostram um novo card ou realizam outras ações quando um evento da Agenda é aberto.
Acionadores de atualização de eventos da Agenda que mostram um novo card ou realizam outras ações quando um usuário edita e salva um evento da Agenda.
Os acionadores onItemsSelected do Drive mostram um novo card ou realizam outras ações quando um usuário seleciona um ou mais arquivos ou pastas no Drive.
Acionadores de texto do Gmail que mostram um card de complemento quando o usuário abre o complemento na janela de texto do Gmail.
Acionadores contextuais do Gmail que mostram um novo card ou realizam outras ações quando o usuário abre uma mensagem do Gmail.
O Editor onFileScopeGranted aciona a exibição de um novo card quando os usuários concedem autorização para o escopo OAuth drive.file no documento atual do Editor.
Na lista acima, apenas os gatilhos da página inicial não são contextuais. Os demais são gatilhos contextuais. Consulte Manifesto para mais informações sobre definições de acionadores de manifesto.
Além dos gatilhos de manifesto, os complementos do Google Workspace também podem usar gatilhos instaláveis do Apps Script.
Restrições
Os gatilhos de manifesto têm algumas restrições de uso.
Esses gatilhos são usados apenas em projetos de complementos do Google Workspace e não têm utilidade em outros aplicativos.
Como eles são definidos no manifesto do complemento e não no código, não é possível usar o serviço Script do Apps Script para criar ou modificar esses gatilhos.
No momento, os acionadores contextuais do Gmail só podem ter um critério unconditional. Isso significa que os acionadores contextuais são ativados para todas as mensagens de e-mail, independente do conteúdo.
Cada complemento pode ter apenas um gatilho de cada tipo por usuário e por documento.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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,["[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\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\nRestrictions\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."]]
