宣告動作

schema.org 中的動作代表可對結構化資料執行的動詞或活動。系統支援多種動作，且這些動作都可以使用類似的結構化資料定義。

Go-To Actions

如果使用 schema.org 實體在內容中加入標記，可以為這些實體新增「前往」動作。舉例來說，如要讓 EmailMessage 實體具有「前往」ViewAction連結，請填入電子郵件的 potentialAction 屬性，如下列範例所示：

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "potentialAction": {
    "@type": "ViewAction",
    "target": "https://watch-movies.com/watch?movieId=abc123",
    "name": "Watch movie"
  },
  "description": "Watch the 'Avengers' movie online"
}
</script>

微資料

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
    <link itemprop="target" href="https://watch-movies.com/watch?movieId=abc123"/>
    <meta itemprop="name" content="Watch movie"/>
  </div>
  <meta itemprop="description" content="Watch the 'Avengers' movie online"/>
</div>

請注意，如果其他電子郵件用戶端不支援電子郵件中的結構定義，系統會自動忽略上述標記。

行動深層連結

「前往」動作也可以直接連結至 Android 和 iOS 原生行動應用程式中的內容。如要深層連結至應用程式，請加入以 android-app:// 和 ios-app:// 架構編碼的其他 target 網址，如下所示：

JSON-LD

"target": [
  “<web url>”,
  “android-app://<android package name>/<scheme>/<host>/<path+query>”,
  “ios-app://<App store ID>/<scheme>/<host><path+query>"
]

微資料

<link itemprop="target" href="<web url>"/>
<link itemprop="target" href="android-app://<android package name>/<scheme>/<host>/<path+query>”/>
<link itemprop="target" href="ios-app://<App store ID>/<scheme>/<host>/<path+query>"/>

延續先前的 EmailMessage 範例：

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "name": "Watch movie",
  ... information about the movie ...
  "potentialAction": {
    "@type": "ViewAction",
    "target": [
      "https://watch-movies.com/watch?movieId=abc123",
      "android-app://com.watchmovies.app/http/watch-movies.com/watch?movieId=abc123",
      "ios-app://12345/movieapp/watch-movies.com/watch?movieId=abc123"
    ]
  }
}
</script>

微資料

<div itemscope itemtype="http://schema.org/EmailMessage">
  <meta itemprop="name" content="Watch movie"/>
  ... information about the movie ...
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
    <meta itemprop="target" content="https://watch-movies.com/watch?movieId=abc123"/>
    <meta itemprop="target" content="android-app://com.watchmovies.android/http/watch-movies.com/watch?movieId=abc123"/>
    <meta itemprop="target" content="ios://12345/movieapp/watch-movies.com/watch?movieId=abc123"/>
 </div>
</div>

如果使用者沒有您的應用程式，系統會將他們帶往您提供的網頁網址。

應用程式內動作

應用程式內動作會在 Gmail 內處理，不會將使用者導向其他網站。應用程式內動作的宣告方式與前往動作類似，但包含額外資訊，方便使用者代理程式 (例如 Gmail) 處理內嵌動作。

您需要為動作宣告 HttpActionHandler，並進行適當設定，而不是使用 target 宣告動作。

舉例來說，如果電子郵件要求使用者核准、確認或瞭解某件事，您可以在郵件中加入確認按鈕。使用者點選按鈕後，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>

即將到期的動作

在許多情況下，動作只在一段時間內有效。與已知日期相關聯的實體 (例如旅遊預訂) 動作會自動過期。行程結束後，Gmail 就不會顯示這項動作。

您也可以明確為動作新增到期日。舉例來說，剪下優待券或儲存優惠代碼的動作可能僅在一段時間內有效。如要設定顯示動作的時間範圍，請設定動作的 startTime 和 endTime 屬性：

JSON-LD

<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "EmailMessage",
  "potentialAction": {
    "@type": "ConfirmAction",
    "name": "Save coupon",
    "handler":  {
       "@type": "HttpActionHandler",
       "url": "https://my-coupons.com/approve?couponId=abc123"
    },
    "startTime": "2015-06-01T12:00:00Z",
    "endTime": "2015-06-05T12:00:00Z"
  }
}
</script>

微資料

<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="potentialAction" itemscope itemtype="http://schema.org/ConfirmAction">
    <meta itemprop="name" content="Save coupon"/>
    <div itemprop="handler" itemscope itemtype="http://schema.org/HttpActionHandler">
      <link itemprop="url" href="https://my-coupons.com/approve?couponId=abc123"/>
    </div>
    <meta itemprop="startTime" content="2015-06-01T12:00:00Z" />
    <meta itemprop="endTime" content="2015-06-05T12:00:00Z" />
  </div>
</div>

延伸閱讀

如要進一步瞭解動作，請參閱：