Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.
Le azioni con un solo clic consentono agli utenti di eseguire operazioni direttamente dalla posta in arrivo senza dover uscire da Gmail. Le azioni con un clic vengono eseguite dichiarando un HttpActionHandler con l'URL del servizio. Per ulteriori dettagli, consulta la sezione Gestione delle richieste di azioni.
Azioni con un clic in Gmail.
Casi d'uso
Le azioni con un clic attualmente supportate in Gmail sono:
Puoi aggiungere un pulsante di conferma con un clic alle email che richiedono agli utenti di approvare, confermare e riconoscere qualcosa. Quando l'utente fa clic sul pulsante, Google invia una richiesta HTTP al tuo servizio, registrando la conferma. È possibile interagire con ConfirmAction solo una volta.
La seguente dichiarazione aggiunge un pulsante ConfirmAction a un'email relativa a una nota spese:
JSON-LD
<scripttype="application/ld+json"> {"@context":"http://schema.org","@type":"EmailMessage","potentialAction":{"@type":"ConfirmAction","name":"Approve Expense","handler":{"@type":"HttpActionHandler","url":"https://myexpenses.com/approve?expenseId=abc123"}},"description":"Approval request for John's $10.13 expense for office supplies"} </script>
Microdati
<divitemscopeitemtype="http://schema.org/EmailMessage"> <divitemprop="potentialAction"itemscopeitemtype="http://schema.org/ConfirmAction"> <metaitemprop="name"content="Approve Expense"/> <divitemprop="handler"itemscopeitemtype="http://schema.org/HttpActionHandler"> <linkitemprop="url"href="https://myexpenses.com/approve?expenseId=abc123"/> </div> </div> <metaitemprop="description"content="Approval request for John's $10.13 expense for office supplies"/> </div>
Salva azione
SaveAction può essere utilizzato per descrivere interazioni come il salvataggio di un coupon o l'aggiunta di brani alla coda di ascolto. È possibile interagire con SaveAction solo una volta.
La seguente dichiarazione aggiunge un pulsante SaveAction a un'email relativa a un'offerta:
JSON-LD
<scripttype="application/ld+json"> {"@context":"http://schema.org","@type":"EmailMessage","potentialAction":{"@type":"SaveAction","name":"Save Offer","handler":{"@type":"HttpActionHandler","url":"https://offers-everywhere.com/save?offerId=xyz789"}},"description":"$5 meal at Joe's Diner"} </script>
Puoi convalidare il markup utilizzando lo Strumento di test del markup delle email. Incolla il codice di markup e fai clic sul pulsante Convalida per analizzare i contenuti e ricevere un report sugli eventuali errori presenti.
Specifica
Per le proprietà disponibili per queste azioni, consulta la documentazione per i tipi specifici ConfirmAction e SaveAction.
[[["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-04 UTC."],[],[],null,["One-click actions allow users to perform operations directly from the inbox without having to leave Gmail. One-click actions are performed by declaring an `HttpActionHandler` with your service URL. For more details, refer to [Handling Action Requests](../actions/handling-action-requests).\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nOne-click actions in Gmail.\n\n\u003cbr /\u003e\n\nUse Cases\n\nOne Click actions currently supported in Gmail are:\n\n- [ConfirmAction](#confirm_action)\n- [SaveAction](#save_action)\n\n| **Note:** Before you start, make sure you understand how to [embed schemas in emails](/workspace/gmail/markup/embedding-schemas-in-emails) and you are familiar with [testing schemas](/workspace/gmail/markup/testing-your-schema).\n\nConfirm Action\n\nYou may add a one-click confirm button to emails requiring users to approve, confirm and acknowledge something. Once the user clicks on the button, an http request will be issued from Google to your service, recording the confirmation. `ConfirmAction` can only be interacted with **once**.\n\nThe following declaration adds a `ConfirmAction` button to an email about an expense report: \n\nJSON-LD \n\n \u003cscript type=\"application/ld+json\"\u003e\n {\n \"@context\": \"http://schema.org\",\n \"@type\": \"EmailMessage\",\n \"potentialAction\": {\n \"@type\": \"ConfirmAction\",\n \"name\": \"Approve Expense\",\n \"handler\": {\n \"@type\": \"HttpActionHandler\",\n \"url\": \"https://myexpenses.com/approve?expenseId=abc123\"\n }\n },\n \"description\": \"Approval request for John's $10.13 expense for office supplies\"\n }\n \u003c/script\u003e\n\nMicrodata \n\n \u003cdiv itemscope itemtype=\"http://schema.org/EmailMessage\"\u003e\n \u003cdiv itemprop=\"potentialAction\" itemscope itemtype=\"http://schema.org/ConfirmAction\"\u003e\n \u003cmeta itemprop=\"name\" content=\"Approve Expense\"/\u003e\n \u003cdiv itemprop=\"handler\" itemscope itemtype=\"http://schema.org/HttpActionHandler\"\u003e\n \u003clink itemprop=\"url\" href=\"https://myexpenses.com/approve?expenseId=abc123\"/\u003e\n \u003c/div\u003e\n \u003c/div\u003e\n \u003cmeta itemprop=\"description\" content=\"Approval request for John's $10.13 expense for office supplies\"/\u003e\n \u003c/div\u003e\n\nSave Action\n\n`SaveAction` can be used to describe interactions like saving a coupon or adding songs to the listen queue. `SaveAction` can only be interacted with **once**.\n\nThe following declaration adds a `SaveAction` button to an email about an offer: \n\nJSON-LD \n\n \u003cscript type=\"application/ld+json\"\u003e\n {\n \"@context\": \"http://schema.org\",\n \"@type\": \"EmailMessage\",\n \"potentialAction\": {\n \"@type\": \"SaveAction\",\n \"name\": \"Save Offer\",\n \"handler\": {\n \"@type\": \"HttpActionHandler\",\n \"url\": \"https://offers-everywhere.com/save?offerId=xyz789\"\n }\n },\n \"description\": \"$5 meal at Joe's Diner\"\n }\n \u003c/script\u003e\n\nMicrodata \n\n \u003cdiv itemscope itemtype=\"http://schema.org/EmailMessage\"\u003e\n \u003cdiv itemprop=\"potentialAction\" itemscope itemtype=\"http://schema.org/SaveAction\"\u003e\n \u003cmeta itemprop=\"name\" content=\"Save Offer\"/\u003e\n \u003cdiv itemprop=\"handler\" itemscope itemtype=\"http://schema.org/HttpActionHandler\"\u003e\n \u003clink itemprop=\"url\" href=\"https://offers-everywhere.com/save?offerId=xyz789\"/\u003e\n \u003c/div\u003e\n \u003c/div\u003e\n \u003cmeta itemprop=\"description\" content=\"$5 meal at Joe's Diner\"/\u003e\n \u003c/div\u003e\n\nTest your markup\n\nYou can validate your markup using the [Email Markup Tester Tool](https://www.google.com/webmasters/markup-tester/). Paste in your markup code and click the **Validate** button to scan the content and receive a report on any errors present.\n\nSpecification\n\nFor properties available to these actions, refer to the documentation for the\nspecific types [ConfirmAction](/workspace/gmail/markup/reference/types/ConfirmAction) and\n[SaveAction](/workspace/gmail/markup/reference/types/SaveAction).\n| **Note:** Some of the schemas used by Google are still going through the standardization process of [schema.org](http://schema.org), and therefore, may change in the future. [Learn More](/workspace/gmail/markup/reference/schema-org-proposals)."]]
