작업 요청 처리

작업 선언에 설명된 대로 사용자가 인앱 작업과 상호작용할 때 Google은 작업에 선언된 URL에 HTTP 요청을 전송합니다.

다음 예에서는 비용 보고서에 관한 이메일에 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>

사용자가 버튼을 클릭하면 Google에서 서비스로 HTTP 요청이 전송되어 확인이 기록됩니다. 서비스는 Google에서 다음 HTTP 요청을 수신합니다.

POST /approve?expenseId=abc123 HTTP/1.1
Host: your-domain.com
Authorization: Bearer AbCdEf123456
Content-Type: application/x-www-form-urlencoded
User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/1.0 (KHTML, like Gecko; Gmail Actions)

confirmed=Approved

이 페이지의 나머지 부분에서는 https://your-domain.com/approve?expenseId=abc123의 서비스가 작업을 올바르게 처리하기 위해 해야 할 작업을 설명합니다. 여기에는 다음이 포함됩니다.

  • 요청 확인
  • 페이로드 처리
  • 응답 코드 반환

1단계: 요청 확인

https://your-domain.com/approve?expenseId=abc123의 서비스는 다음을 확인하는 것이 좋습니다.

모든 작업 요청의 사용자 에이전트는 Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/1.0 (KHTML, like Gecko; Gmail Actions)입니다.

모든 검사가 통과하면 서비스가 다음 단계로 진행할 수 있습니다.

2단계: 작업 처리

서비스는 URL 매개변수에 지정된 대로 작업과 사용자로부터 수집된 추가 정보를 처리해야 합니다.

사용자의 추가 정보는 요청 본문에 있으며 x-www-form-urlecoded 인코딩을 사용하여 인코딩됩니다. 이 정보는 이름이 작업의 속성과 일치하는 속성에서 설정됩니다. 예를 들어 ConfirmAction에는 confirmed 속성이 있습니다.

3단계: 응답 코드 반환

서비스가 작업을 처리하고 기록한 후에는 응답 코드 200 (OK)를 반환해야 합니다. 오류 상황에서 다음 응답 코드를 사용할 수 있습니다.

응답 코드 실험군
400 (Bad Request) Google에서 작업을 실패로 처리합니다.
401 (Unauthorized) Google에서 작업을 실패로 처리합니다.
404(찾을 수 없음) Google에서 작업을 실패로 처리합니다.
408 (요청 시간 초과) Google에서 나중에 다시 시도합니다.

영구적인 실패의 경우 Google에서는 사용자에게 작업이 실패했으며 이메일 내의 대체 안내를 따라야 한다고 안내합니다.

추가 자료