원클릭 액션

원클릭 작업을 사용하면 사용자가 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의 문서를 참고하세요.