Ein-Klick-Aktionen

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.

Bestätigungsschaltfläche in Gmail
Aktionen mit einem Klick in Gmail.

Anwendungsfälle

Die folgenden Aktionen mit einem Klick werden derzeit in Gmail unterstützt:

Aktion bestätigen

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

<script type="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

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ConfirmAction">
    <meta itemprop="name" content="Approve Expense"/>
    <div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
      <link itemprop="url" href="https://myexpenses.com/approve?expenseId=abc123"/>
    </div>
  </div>
  <meta itemprop="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

<script type="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>

Mikrodaten

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/SaveAction">
    <meta itemprop="name" content="Save Offer"/>
    <div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
      <link itemprop="url" href="https://offers-everywhere.com/save?offerId=xyz789"/>
    </div>
  </div>
  <meta itemprop="description" content="$5 meal at Joe's Diner"/>
</div>

Markup testen

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.