ワンクリック アクションにより、ユーザーは Gmail を離れることなく、受信トレイから直接操作を行うことができます。ワンクリック アクションを実行するには、サービス URL で HttpActionHandler
を宣言します。詳しくは、アクション リクエストの処理をご覧ください。
![Gmail の確認ボタン](https://developers.google.cn/gmail/markup/images/actions-one-click-action.png?authuser=5&hl=ja)
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。