訂單是交易的確認 (收據),可包含多個明細項目,每個項目都代表客戶接受的方案。
用途
基本訂單
訂單的最小範例
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Order",
"merchant": {
"@type": "Organization",
"name": "Amazon.com"
},
"orderNumber": "123-4567890-1234567",
"priceCurrency": "USD",
"price": "29.99",
"acceptedOffer": {
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Google Chromecast"
},
"price": "29.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "1"
}
}
}
</script>
微資料
<div itemscope itemtype="http://schema.org/Order">
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Amazon.com"/>
</div>
<meta itemprop="orderNumber" content="123-4567890-1234567"/>
<meta itemprop="priceCurrency" content="USD"/>
<meta itemprop="price" content="29.99"/>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
</div>
<meta itemprop="price" content="29.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="1"/>
</div>
</div>
</div>
「查看訂單」動作
如要為訂單新增 View Order 按鈕,請設定 url 屬性。如要直接連結至行動應用程式,請一併新增 ViewAction:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Order",
"merchant": {
"@type": "Organization",
"name": "Amazon.com"
},
"orderNumber": "123-4567890-1234567",
"orderStatus": "http://schema.org/OrderProcessing",
"priceCurrency": "USD",
"price": "29.99",
"priceSpecification": {
"@type": "PriceSpecification",
"validFrom": "2027-12-07T23:30:00-08:00"
},
"acceptedOffer": {
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Google Chromecast",
"sku": "B00DR0PDNE",
"url": "http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/",
"image": "http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"
},
"price": "29.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "1"
}
},
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567",
"potentialAction": {
"@type": "ViewAction",
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"
}
}
</script>
微資料
<div itemscope itemtype="http://schema.org/Order">
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Amazon.com"/>
</div>
<link itemprop="orderStatus" href="http://schema.org/OrderProcessing"/>
<meta itemprop="orderNumber" content="123-4567890-1234567"/>
<meta itemprop="priceCurrency" content="USD"/>
<meta itemprop="price" content="29.99"/>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
<link itemprop="url" href="http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/"/>
<link itemprop="image" href="http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"/>
<meta itemprop="sku" content="B00DR0PDNE"/>
</div>
<meta itemprop="price" content="29.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="1"/>
</div>
</div>
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
</div>
<div itemprop="priceSpecification" itemscope itemtype="http://schema.org/PriceSpecification">
<meta itemprop="validFrom" content="2027-12-07T23:30:00-08:00"/>
</div>
</div>
訂單 (含帳單詳細資料)
含有詳細帳單資訊的訂單範例
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Order",
"merchant": {
"@type": "Organization",
"name": "Amazon.com"
},
"orderNumber": "123-4567890-1234567",
"priceCurrency": "USD",
"price": "539.00",
"priceSpecification": {
"@type": "PriceSpecification",
"validFrom": "2027-12-07T23:30:00-08:00"
},
"acceptedOffer": [
{
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Samsung Chromebook",
"sku": "B009LL9VDG",
"url": "http://www.amazon.com/Samsung-XE303C12-A01US-Chromebook-Wi-Fi-11-6-Inch/dp/B009LL9VDG/",
"image": "http://ecx.images-amazon.com/images/I/81H-DO3qX0L._SX522_.jpg"
},
"price": "249.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "2"
},
"seller": {
"@type": "Organization",
"name": "Samsung Marketplace Store"
}
},
{
"@type": "Offer",
"itemOffered": {
"@type": "Product",
"name": "Google Chromecast",
"sku": "B00DR0PDNE",
"url": "http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/",
"image": "http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"
},
"price": "29.99",
"priceCurrency": "USD",
"eligibleQuantity": {
"@type": "QuantitativeValue",
"value": "1"
},
"seller": {
"@type": "Organization",
"name": "Google Store @ Amazon"
}
}
],
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567",
"potentialAction": {
"@type": "ViewAction",
"url": "https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"
},
"orderStatus": "http://schema.org/OrderProcessing",
"paymentMethod": {
"@type": "PaymentMethod",
"name": "http://schema.org/CreditCard"
},
"paymentMethodId": "**** **** **** 1234",
"orderDate": "2027-11-07T23:30:00-08:00",
"isGift": "false",
"discount": "0.97",
"discountCurrency": "USD",
"customer": {
"@type": "Person",
"name": "John Smith"
},
"billingAddress": {
"@type": "PostalAddress",
"name": "Google",
"streetAddress": "1600 Amphitheatre Pkwy",
"addressLocality": "Mountain View",
"addressRegion": "CA",
"addressCountry": "USA"
}
}
</script>
微資料
<div itemscope itemtype="http://schema.org/Order">
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Amazon.com"/>
</div>
<meta itemprop="orderNumber" content="123-4567890-1234567"/>
<meta itemprop="priceCurrency" content="USD"/>
<meta itemprop="price" content="539.00"/>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Samsung Chromebook"/>
<meta itemprop="sku" content="B009LL9VDG"/>
<link itemprop="url" href="http://www.amazon.com/Samsung-XE303C12-A01US-Chromebook-Wi-Fi-11-6-Inch/dp/B009LL9VDG/"/>
<link itemprop="image" href="http://ecx.images-amazon.com/images/I/81H-DO3qX0L._SX522_.jpg"/>
</div>
<meta itemprop="price" content="249.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="2"/>
</div>
<div itemprop="seller" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Samsung Marketplace Store"/>
</div>
</div>
<div itemprop="acceptedOffer" itemscope itemtype="http://schema.org/Offer">
<div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
<meta itemprop="sku" content="B00DR0PDNE"/>
<link itemprop="url" href="http://www.amazon.com/Google-Chromecast-Streaming-Media-Player/dp/B00DR0PDNE/"/>
<link itemprop="image" href="http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"/>
</div>
<meta itemprop="price" content="29.99"/>
<meta itemprop="priceCurrency" content="USD"/>
<div itemprop="eligibleQuantity" itemscope itemtype="http://schema.org/QuantitativeValue">
<meta itemprop="value" content="1"/>
</div>
<div itemprop="seller" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Google Store @ Amazon"/>
</div>
</div>
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/ViewAction">
<link itemprop="url" href="https://www.amazon.ca/gp/css/summary/edit.html/orderID=123-4567890-1234567"/>
</div>
<link itemprop="orderStatus" href="http://schema.org/OrderProcessing"/>
<div itemprop="paymentMethod" itemscope itemtype="http://schema.org/PaymentMethod">
<meta itemprop="name" content="http://schema.org/CreditCard"/>
</div>
<meta itemprop="paymentMethodId" content="**** **** **** 1234"/>
<meta itemprop="orderDate" content="2027-11-07T23:30:00-08:00"/>
<meta itemprop="isGift" content="false"/>
<meta itemprop="discount" content="0.97"/>
<meta itemprop="discountCurrency" content="USD"/>
<div itemprop="customer" itemscope itemtype="http://schema.org/Person">
<meta itemprop="name" content="John Smith"/>
</div>
<div itemprop="billingAddress" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="name" content="Google"/>
<meta itemprop="streetAddress" content="1600 Amphitheatre Pkwy"/>
<meta itemprop="addressLocality" content="Mountain View"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="addressCountry" content="USA"/>
</div>
<div itemprop="priceSpecification" itemscope itemtype="http://schema.org/PriceSpecification">
<meta itemprop="validFrom" content="2027-12-07T23:30:00-08:00"/>
</div>
</div>
測試標記
您可以使用電子郵件標記測試工具驗證標記。貼上標記程式碼,然後按一下「驗證」按鈕掃描內容,並取得錯誤報表。
規格
下表列出這個類型的所有可用屬性:
| 屬性 | 類型 | 說明 |
|---|---|---|
| 商家 | Organization 或 Person | (必填) 負責處理訂單的當事人 (例如 Amazon.com 是許多賣家的商家)。也接受字串 (例如「Amazon.com」)。 |
| merchant.name | 文字 | (必填) 機構名稱。 |
| merchant.sameAs | 網址 | 商家的 Freebase 網址。 |
| orderNumber | 文字 | (必填) 交易的商家專屬 ID。 |
| priceCurrency | 文字 | (必要) 訂單價格的幣別 (由 3 個英文字母組成,採 ISO 4217 格式)。 |
| 價格 | 數字或文字 | (必要) 整筆交易的總價。 |
| acceptedOffer | Offer | (必要) 訂單中包含的優惠。也接受物件陣列。 |
| acceptedOffer.itemOffered | 產品或預訂 | (必要) 要販售的商品。 |
| acceptedOffer.itemOffered.name | 文字 | (必填) 產品名稱。 |
| acceptedOffer.itemOffered.sku | 文字 | (建議用於確認資訊卡/搜尋答案) 存貨單位 (SKU),也就是商家專屬的產品或服務 ID,或是優惠所指的產品。 |
| acceptedOffer.itemOffered.url | 網址 | (建議用於確認資訊卡/搜尋答案) 產品網址,通常是商家網站上的產品到達網頁。 |
| acceptedOffer.itemOffered.image | 網址 | (建議用於確認資訊卡/搜尋答案) 產品圖片的網址,通常是商家網站上的圖片。 |
| acceptedOffer.itemOffered.color | 文字 | 產品顏色。 |
| acceptedOffer.price | 數字或文字 | (必填) 產品的單價。 |
| acceptedOffer.priceCurrency | 文字 | (必要) 價格的幣別 (由 3 個英文字母組成,採 ISO 4217 格式)。 |
| acceptedOffer.eligibleQuantity | QuantitativeValue | (必填) 訂購數量間隔和測量單位,適用於優惠或價格規格。 |
| acceptedOffer.eligibleQuantity.value | 數字 | (必填) 產品特徵的值。 |
| acceptedOffer.priceSpecification | PriceSpecification | 一或多項詳細價格規格,指出單價和運費或付款費用。 |
| acceptedOffer.priceSpecification.price | 數字或文字 | 整筆交易的總價。 |
| acceptedOffer.priceSpecification.priceCurrency | 文字 | 訂單價格的幣別 (由 3 個英文字母組成,採 ISO 4217 格式)。 |
| acceptedOffer.itemCondition | OfferItemCondition | 產品或服務的狀況說明,或是方案中包含的產品或服務。 |
| acceptedOffer.seller | Organization 或 Person | 下單的對象。也可以接受字串 (例如「」)。 |
| acceptedOffer.seller.name | 文字 | 機構名稱。 |
| priceSpecification | PriceSpecification | (建議用於確認資訊卡/搜尋答案) 價格/價格幣別的任何更詳細替代方案。也用於指定稅金和運費。也接受物件陣列。 |
| 網址 | 網址 | (建議用於確認資訊卡/Google 搜尋答案) 訂單網址,通常是商家網站的連結,使用者可透過該連結取得訂單的詳細資訊。 |
| orderStatus | OrderStatus | (建議用於確認資訊卡/搜尋答案) 訂單的目前狀態。 |
| paymentMethod | PaymentMethod | 訂單的信用卡或其他付款方式名稱。 |
| paymentMethodId | 文字 | 所用付款方式的 ID (例如信用卡末 4 碼)。 |
| orderDate | DateTime | 下單日期。 |
| isGift | 布林值 | 優惠是否已接受,但禮物要送給買家以外的人。 |
| discount | 數字或文字 | 已套用任何折扣。 |
| discountCurrency | 文字 | 折扣的幣別 (由 3 個英文字母組成,採 ISO 4217 格式)。 |
| 客戶 | Person 或 Organization | 下單方。 |
| customer.name | 文字 | 人員姓名。 |
| billingAddress | PostalAddress | 訂單的帳單地址。 |
| billingAddress.name | 文字 | PostalAddress 的名稱。 |
| billingAddress.streetAddress | 文字 | 街道地址。例如:1600 Amphitheatre Pkwy。 |
| billingAddress.addressLocality | 文字 | 縣市。例如山景城。 |
| billingAddress.addressRegion | 文字 | 地區。例如 CA。 |
| billingAddress.addressCountry | 文字或國家/地區 | 國家/地區。例如「美國」。你也可以提供由兩個英文字母組成的 ISO 3166-1 alpha-2 國家/地區代碼。 |