處理動作要求

如「宣告動作」所述，當使用者與應用程式內動作互動時，Google 會向動作中宣告的網址傳送 HTTP 要求。

以下範例會在支出報表相關電子郵件中新增 ConfirmAction 按鈕：

<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 的服務檢查：

• 限制使用存取權杖 - 為防範重送攻擊。
• 使用者代理程式 - 確認要求是否來自 Google。
• 不記名權杖 - 用來確保 Google 發出的要求是用於服務。

所有動作要求的使用者代理程式為 Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/1.0 (KHTML, like Gecko; Gmail Actions)。

如果通過所有檢查，服務就會繼續進行下一個步驟。

步驟 2：處理動作

服務會依照網址參數中指定的動作，以及從使用者收集的其他資訊處理。

使用者提供的其他資訊位於要求主體中，且使用 x-www-form-urlecoded 編碼加以編碼。這項資訊是在名稱與 Action 屬性相對應的屬性中設定。例如，ConfirmAction 具有 confirmed 屬性。

步驟 3：傳回回應代碼

服務順利處理並記錄動作後，應會傳回回應代碼 200 (OK)。下列回應代碼可能用於錯誤情況：

如果永久性錯誤，Google 會通知使用者操作失敗，請使用者按照電子郵件中的替代指示進行。

延伸閱讀

• 保護動作