Estendere Gmail con i componenti aggiuntivi di Google Workspace
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Lo scopo di molte email è quello di indurre il destinatario a svolgere un'attività specifica o
raggiungere un obiettivo, ad esempio aggiungere un evento al calendario, compilare un modulo, effettuare una
prenotazione o utilizzare altre applicazioni. Tuttavia, i destinatari devono
completare l'attività senza ulteriori richieste, spesso eseguendo una serie di
passaggi manuali.
Puoi far risparmiare tempo e fatica ai tuoi utenti automatizzando queste attività con i componenti aggiuntivi di Google Workspace. Quando un utente legge o compone un messaggio in Gmail,
un componente aggiuntivo di Google Workspace può presentare un'interfaccia utente interattiva e personalizzata che consente
all'utente di agire sul messaggio in vari modi, ad esempio:
Visualizzazione di informazioni aggiuntive per l'utente nell'interfaccia utente di Gmail.
Connessione a servizi non Google per recuperare informazioni o intraprendere altre
azioni.
Fornire i mezzi per controllare il comportamento del componente aggiuntivo o inviare informazioni a
un altro servizio.
I componenti aggiuntivi di Google Workspace possono definire i seguenti tipi di estensioni all'interno di
Gmail:
Inoltre, i componenti aggiuntivi di Google Workspace che estendono Gmail lo fanno sia sui client desktop che su quelli mobili.
Home page di Gmail
Gmail supporta la visualizzazione delle home page dei componenti aggiuntivi di Google Workspace.
Per mostrare la home page comune del componente aggiuntivo in Gmail, assicurati che
nel manifest del componente aggiuntivo sia presente un campo addOns.gmail.
In alternativa, aggiungi un
gmail.homepageTrigger
al manifest dell'add-on per fornire una home page specifica di Gmail.
In entrambi i casi, devi fornire il nome di una funzione di attivazione della home page nel progetto di script del componente aggiuntivo. Questa funzione viene chiamata automaticamente per creare la
home page di Gmail quando è necessario. Devi implementare questa funzione per creare e restituire un singolo oggetto Card o un array di oggetti Card che compongono la home page. Alla funzione di attivazione della home page viene passato un
oggetto evento
come parametro che contiene alcune informazioni generali, ad esempio la
piattaforma del client. Puoi utilizzare i dati dell'oggetto evento per personalizzare la creazione della
home page.
Scopri cosa puoi creare
I componenti aggiuntivi di Google Workspace vengono creati utilizzando Apps Script e le loro
interfacce definite utilizzando il
servizio di schede di Apps Script. Per una panoramica, vedi
Creazione di componenti aggiuntivi di Google Workspace. Il comportamento dei componenti aggiuntivi Google Workspace viene configurato utilizzando un
manifest, che include
sezioni specifiche di Gmail.
Quando configuri il componente aggiuntivo di Google Workspace per estendere Gmail, devi
decidere quali interfacce creare per il componente aggiuntivo e quali azioni può intraprendere.
Per saperne di più, consulta le seguenti guide:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)"]]