Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Mit Ein-Klick-Aktionen können Nutzer Vorgänge direkt im Posteingang ausführen, ohne Gmail verlassen zu müssen. Aktionen mit einem Klick werden ausgeführt, indem Sie ein HttpActionHandler mit Ihrer Dienst-URL deklarieren. Weitere Informationen finden Sie unter Aktionsanfragen verarbeiten.
Aktionen mit einem Klick in Gmail.
Anwendungsfälle
Die folgenden Aktionen mit einem Klick werden derzeit in Gmail unterstützt:
Sie können E-Mails, in denen Nutzer etwas genehmigen, bestätigen oder zur Kenntnis nehmen müssen, eine Schaltfläche zum Bestätigen mit nur einem Klick hinzufügen. Sobald der Nutzer auf die Schaltfläche klickt, wird von Google eine HTTP-Anfrage an Ihren Dienst gesendet, um die Bestätigung zu erfassen. Mit ConfirmAction kann nur einmal interagiert werden.
Durch die folgende Deklaration wird einer E-Mail zu einem Spesenabrechnungsbericht die Schaltfläche ConfirmAction hinzugefügt:
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>
Mikrodaten
<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>
Aktion speichern
SaveAction kann verwendet werden, um Interaktionen wie das Speichern eines Gutscheins oder das Hinzufügen von Songs zur Wiedergabeliste zu beschreiben. Mit SaveAction kann nur einmal interagiert werden.
Durch die folgende Deklaration wird einer E-Mail zu einem Angebot die Schaltfläche SaveAction hinzugefügt:
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>
Sie können Ihr Markup mit dem E-Mail-Markup-Tester validieren. Fügen Sie den Markup-Code ein und klicken Sie auf die Schaltfläche Validieren, um den Inhalt zu scannen und einen Bericht zu allen vorhandenen Fehlern zu erhalten.
Spezifikation
Informationen zu den für diese Aktionen verfügbaren Attributen finden Sie in der Dokumentation für die spezifischen Typen ConfirmAction und SaveAction.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-29 (UTC)."],[],[],null,["# One Click Actions\n\nOne-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---------\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--------------\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\n### JSON-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\n### Microdata\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\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\n### JSON-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\n### Microdata\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----------------\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-------------\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)."]]
