ワンクリック アクション

ワンクリック アクションを使用すると、Gmail を離れることなく受信トレイから直接操作を実行できます。ワンクリック アクションは、サービス URL を使用して HttpActionHandler を宣言することで実行されます。詳細については、アクション リクエストの処理をご覧ください。

Gmail の確認ボタン
Gmail のワンクリック アクション。

ユースケース

Gmail で現在サポートされているワンクリック アクションは次のとおりです。

操作の確認

ユーザーに承認、確認、承認を求めるメールには、ワンクリック確認ボタンを追加できます。ユーザーがボタンをクリックすると、Google からサービスに HTTP リクエストが発行され、確認が記録されます。ConfirmAction は1 回しか操作できません。

次の宣言は、経費レポートに関するメールに 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>

microdata

<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 は 1 回だけ操作できます。

次の宣言は、オファーに関するメールに 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>

microdata

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

マークアップをテスト

メール マークアップ テスター ツールを使用して、マークアップを検証できます。マークアップ コードを貼り付け、[検証] ボタンをクリックしてコンテンツをスキャンし、エラーがある場合はレポートを受け取ります。

仕様

これらのアクションで使用できるプロパティについては、特定のタイプ ConfirmAction と SaveAction のドキュメントをご覧ください。