注文とは、トランザクションの確認(領収書)であり、複数の明細項目を含むことができます。各明細項目は、購入者が承諾した Offer で表されます。
ユースケース
基本的な注文
注文の最も簡単な例:
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>
microdata
<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>
注文を確認するアクション
url プロパティを設定すると、注文に
[View Order]
ボタンを追加できます。モバイルアプリに直接リンクするには、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>
microdata
<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>
microdata
<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>
マークアップをテスト
メール マークアップ テスターツールを使用して、マークアップを検証できます。 マークアップ コードを貼り付けて [Validate](検証)ボタンをクリックすると、コンテンツがスキャンされ、エラーに関するレポートが生成されます。
仕様
次の表に、このタイプで使用可能なすべてのプロパティを示します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| merchant | Organization または Person | (必須 )注文を受ける当事者(例: Amazon.com は多くの販売者の販売者です)。文字列(例: 「Amazon.com」)も使用できます。 |
| merchant.name | テキスト | (必須 )組織の名前。 |
| merchant.sameAs | URL | 販売者の Freebase URL。 |
| orderNumber | テキスト | (必須 )トランザクションを表す販売者固有の識別子。 |
| priceCurrency | テキスト | (必須 )注文価格の通貨(3 文字の ISO 4217 形式)。 |
| 価格 | 数値またはテキスト | (必須 )トランザクション全体の合計金額。 |
| acceptedOffer | 特典 | (必須 )注文に含まれる特典。オブジェクトの配列も使用できます。 |
| acceptedOffer.itemOffered | 商品または予約 | (必須 )販売する商品アイテム。 |
| acceptedOffer.itemOffered.name | テキスト | (必須 )商品の名前。 |
| acceptedOffer.itemOffered.sku | テキスト | (確認カード/検索回答に推奨 )最小管理単位(SKU)。つまり、商品やサービスを表す販売者固有の識別子、または特典が参照する商品。 |
| acceptedOffer.itemOffered.url | URL | (確認カード/検索回答に推奨 )商品の URL。通常は、販売者のウェブサイトの商品ランディング ページ。 |
| acceptedOffer.itemOffered.image | URL | (確認カード/検索回答に推奨 )商品の画像の URL。通常は、販売者のウェブサイトの画像。 |
| acceptedOffer.itemOffered.color | テキスト | 商品の色。 |
| acceptedOffer.price | 数値またはテキスト | (必須 )商品の単価。 |
| acceptedOffer.priceCurrency | テキスト | (必須 )価格の通貨(3 文字の ISO 4217 形式)。 |
| acceptedOffer.eligibleQuantity | QuantitativeValue | (必須 )特典または価格仕様が有効な注文数量の間隔と測定単位。 |
| acceptedOffer.eligibleQuantity.value | 数値 | (必須 )商品の特性の値。 |
| acceptedOffer.priceSpecification | PriceSpecification | 単価と配送料または支払い手数料を示す、1 つ以上の詳細な価格仕様。 |
| acceptedOffer.priceSpecification.price | 数値またはテキスト | トランザクション全体の合計金額。 |
| acceptedOffer.priceSpecification.priceCurrency | テキスト | 注文価格の通貨(3 文字の ISO 4217 形式)。 |
| acceptedOffer.itemCondition | OfferItemCondition | 商品やサービスの状態、または特典に含まれる商品やサービスの説明文。 |
| acceptedOffer.seller | Organization または Person | 注文が行われた当事者。文字列(例: 「」)も使用できます。 |
| acceptedOffer.seller.name | テキスト | 組織の名前。 |
| priceSpecification | PriceSpecification | (確認カード/検索回答に推奨 )価格/priceCurrency の詳細な代替手段。税金と配送料を指定するためにも使用されます。オブジェクトの配列も使用できます。 |
| URL | URL | (確認カード/検索回答に推奨 )注文の URL。通常は、注文の詳細を確認できる販売者のウェブサイトへのリンク。 |
| orderStatus | OrderStatus | (確認カード/検索回答に推奨 )注文の現在のステータス。 |
| paymentMethod | PaymentMethod | 注文のクレジット カードまたはその他の支払い方法の名前。 |
| paymentMethodId | テキスト | 使用した支払い方法の識別子(例: クレジット カード番号の下 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 | テキスト | 地名。例: Mountain View。 |
| billingAddress.addressRegion | テキスト | リージョン。例: CA。 |
| billingAddress.addressCountry | テキストまたは国 | 国。例: USA。ISO 3166-1 alpha-2 の 2 文字の国コードを指定することもできます。 |