一键式操作

借助一键式操作,用户无需离开 Gmail 即可直接从收件箱执行操作。使用服务网址声明 HttpActionHandler 即可执行一键式操作。如需了解详情,请参阅处理操作请求

Gmail 中的确认按钮
Gmail 中的一键式操作。

使用场景

Gmail 目前支持的一键式操作包括:

确认操作

您可以在电子邮件中添加一键确认按钮,要求用户进行批准、确认和确认。用户点击该按钮后,Google 会向您的服务发出一个 http 请求,记录确认信息。ConfirmAction 只能与一次互动。

以下声明会向有关费用报告的电子邮件添加一个 ConfirmAction 按钮:

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>

微数据

<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>

保存操作

SaveAction 可用于描述互动情况,例如保存优惠券或将歌曲添加到收听队列。SaveAction 只能与一次互动。

以下声明会向有关优惠的电子邮件添加一个 SaveAction 按钮:

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>

微数据

<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>

测试您的标记

您可以使用电子邮件标记测试工具验证您的标记。粘贴您的标记代码并点击验证按钮,即可扫描相应内容,并在报告出现任何错误时收到相应报告。

规范

如需了解可用于这些操作的属性,请参阅介绍特定类型 ConfirmActionSaveAction 的文档。