Cómo extender Gmail con complementos de Google Workspace
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
El propósito de muchos correos electrónicos es lograr que el destinatario realice una tarea específica o alcance un objetivo, como agregar un evento al calendario, completar un formulario, hacer una reserva o usar otras aplicaciones. Sin embargo, los destinatarios deben completar la tarea sin más indicaciones, a menudo realizando varios pasos manuales.
Puedes ahorrar tiempo y esfuerzo a tus usuarios automatizando estas tareas con complementos de Google Workspace. Cuando un usuario lee o redacta un mensaje en Gmail, un complemento de Google Workspace puede presentar una IU interactiva y personalizada que le permita realizar diversas acciones en el mensaje, como las siguientes:
Mostrar información adicional para el usuario en la IU de Gmail
Establecer conexión con servicios ajenos a Google para recuperar información o realizar otras acciones
Proporcionar los medios para controlar el comportamiento del complemento o enviar información a otro servicio
Los complementos de Google Workspace pueden definir los siguientes tipos de extensiones en Gmail:
Además, los complementos de Google Workspace que extienden Gmail lo hacen en clientes para computadoras y dispositivos móviles.
Páginas principales de Gmail
Gmail admite la visualización de las páginas principales de los complementos de Google Workspace.
Para mostrar la página principal común del complemento en Gmail, asegúrate de que haya un campo addOns.gmail en el manifiesto del complemento.
Como alternativa, agrega un gmail.homepageTrigger al manifiesto del complemento para proporcionar una página principal específica de Gmail.
En cualquier caso, debes proporcionar el nombre de una función de activación de la página principal en el proyecto de secuencia de comandos de tu complemento. Se llama automáticamente a esta función para compilar la página principal de Gmail cuando es necesario. Debes implementar esta función para compilar y devolver un solo objeto Card o un array de objetos Card que componen la página principal. A la función de activación de la página principal se le pasa un objeto de evento como parámetro que contiene información general, como la plataforma del cliente. Puedes usar los datos del objeto de evento para personalizar la creación de la página principal.
Descubre lo que puedes crear
Los complementos de Google Workspace se crean con Apps Script, y sus interfaces se definen con el servicio de tarjetas de Apps Script. Consulta Cómo compilar complementos de Google Workspace para obtener una descripción general. El comportamiento de los complementos de Google Workspace se configura con un manifiesto, que incluye secciones específicas de Gmail.
Cuando configures tu complemento de Google Workspace para extender Gmail, debes decidir qué interfaces crearás para tu complemento y qué acciones puede realizar.
Consulta las siguientes guías para obtener más información:
[[["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-08-29 (UTC)"],[[["\u003cp\u003eGoogle Workspace add-ons automate tasks within Gmail, saving users time and effort by providing interactive UI elements within emails.\u003c/p\u003e\n"],["\u003cp\u003eAdd-ons enhance the Gmail experience by displaying extra information, connecting to external services, and letting users control add-on behavior.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can build custom add-ons with Apps Script and the Card service to extend Gmail's functionality on both desktop and mobile.\u003c/p\u003e\n"],["\u003cp\u003eGmail add-ons can have homepages, contextual interfaces triggered by opening or composing emails, and the ability to create new drafts automatically.\u003c/p\u003e\n"],["\u003cp\u003eTo learn more about building and configuring Gmail add-ons, explore the provided resources on extending UI, composing messages, manifests, and scopes.\u003c/p\u003e\n"]]],["Google Workspace add-ons automate tasks within Gmail, saving users time. They enable interactive UIs when users read or compose messages, allowing actions like displaying information, connecting to external services, and controlling add-on behavior. Add-ons can create contextual interfaces for messages and compose actions, or automatically generate drafts. Developers can define homepages and other interfaces, customize them with event objects, and use Apps Script to build and configure these add-ons through manifests. They support both desktop and mobile Gmail clients.\n"],null,["# Extending Gmail with Google Workspace add-ons\n\nThe purpose of many emails is to get the recipient to do a specific task or\nreach a goal, such as adding a calendar event, filling out a form, making a\nreservation, or using other applications. However, recipients then have to\ncomplete the task without any further prompting, often doing a number of\nmanual steps.\n\nYou can save time and effort for your users by automating these tasks with\nGoogle Workspace add-ons. When a user reads or composes a message in Gmail,\na Google Workspace add-on can present an interactive, customized UI that lets\nthe user act on the message in various ways, such as by:\n\n- Displaying additional information for the user in the Gmail UI.\n- Connecting to non-Google services, to retrieve information or take other actions.\n- Providing the means to control the add-on behavior or send information to another service.\n\n| **Note:** You can also [develop your own chatbots](/hangouts/chat) to enhance the Gmail experience.\n\nGoogle Workspace add-ons can define the following kinds of extensions within\nGmail:\n\n- [Homepages](/workspace/add-ons/concepts/homepages) and other non-contextual cards.\n- Contextual interfaces that appear when users [open Gmail messages](/workspace/add-ons/gmail/extending-message-ui).\n- Contextual interfaces that appear when a user [composes a message or reply](/workspace/add-ons/gmail/extending-compose-ui).\n- Automatically [create new message drafts](/workspace/add-ons/gmail/compose) in response to user interactions.\n\nIn addition, Google Workspace add-ons that extend Gmail do so on both desktop and mobile\nclients.\n\nGmail homepages\n---------------\n\nGmail supports displaying Google Workspace add-on\n[homepages](/workspace/add-ons/concepts/homepages).\nTo show your add-on's common homepage in Gmail simply make sure there\nis a [`addOns.gmail`](/apps-script/manifest/addons#AddOns.FIELDS.gmail)\nfield in the add-on's manifest.\n\nAlternatively, add a\n[`gmail.homepageTrigger`](/apps-script/manifest/gmail-addons#Gmail.FIELDS.homepageTrigger)\nto the add-on manifest to provide a Gmail-specific homepage.\n\nIn either case, you must provide the name of a homepage trigger function in your\nadd-on's script project. This function is automatically called to build the\nGmail homepage when it is needed. You must implement this function to build\nand return a single\n[`Card`](/apps-script/reference/card-service/card) or an array of\n[`Card`](/apps-script/reference/card-service/card)\nobjects that make up the homepage. The homepage trigger function is passed an\n[event object](/workspace/add-ons/concepts/event-objects)\nas a parameter that contains some general information such as the client's\nplatform. You can use the event object data to tailor the construction of the\nhomepage.\n\nSee what you can make\n---------------------\n\nGoogle Workspace add-ons are built using [Apps Script](/apps-script), and their\ninterfaces defined using the Apps Script\n[Card service](/apps-script/reference/card-service). See\n[Building Google Workspace add-ons](/workspace/add-ons/how-tos/building-workspace-addons)\nfor an overview. Google Workspace add-on behavior is configured using a\n[manifest](/workspace/add-ons/concepts/workspace-manifests), which includes\nGmail-specific sections.\n\nWhen configuring your Google Workspace add-on to extend Gmail, you must\ndecide what interfaces to create for your add-on and what actions it can take.\nSee the following guides for more information:\n\n- [Extending the message UI](/workspace/add-ons/gmail/extending-message-ui)\n- [Extending the compose UI with compose actions](/workspace/add-ons/gmail/extending-compose-ui)\n- [Compose draft messages](/workspace/add-ons/gmail/compose)\n- [Manifests](/workspace/add-ons/concepts/workspace-manifests)\n- [Gmail scopes](/workspace/add-ons/concepts/workspace-scopes#gmail_add-on_scopes)\n- Try a sample: [Analyze and label Gmail messages with Gemini and Vertex AI](/workspace/add-ons/samples/gmail-sentiment-analysis-ai)"]]
