원클릭 액션

원클릭 작업을 사용하면 사용자가 Gmail을 벗어나지 않고도 받은편지함에서 직접 작업을 실행할 수 있습니다. 원클릭 작업은 서비스 URL로 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>

마크업 테스트

이메일 마크업 테스터 도구를 사용하여 마크업의 유효성을 검사할 수 있습니다. 마크업 코드를 붙여넣고 검증 버튼을 클릭하여 콘텐츠를 검사하고 있는 오류에 관한 보고서를 받습니다.

사양

이러한 작업에 사용할 수 있는 속성은 특정 유형 ConfirmAction 및 SaveAction의 문서를 참고하세요.