このテンプレートを使用して、荷物の配送状況を記述します。
ユースケース
基本的な荷物の配達
荷物の配達の最小限の例:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "ParcelDelivery",
"deliveryAddress": {
"@type": "PostalAddress",
"name": "Pickup Corner",
"streetAddress": "24 Willie Mays Plaza",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"addressCountry": "US",
"postalCode": "94107"
},
"expectedArrivalUntil": "2027-03-12T12:00:00-08:00",
"carrier": {
"@type": "Organization",
"name": "FedEx"
},
"itemShipped": {
"@type": "Product",
"name": "Google Chromecast"
},
"partOfOrder": {
"@type": "Order",
"orderNumber": "176057",
"merchant": {
"@type": "Organization",
"name": "Bob Dole"
}
}
}
</script>
microdata
<div itemscope itemtype="http://schema.org/ParcelDelivery">
<div itemprop="deliveryAddress" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="name" content="Pickup Corner"/>
<meta itemprop="streetAddress" content="24 Willie Mays Plaza"/>
<meta itemprop="addressLocality" content="San Francisco"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="addressCountry" content="US"/>
<meta itemprop="postalCode" content="94107"/>
</div>
<meta itemprop="expectedArrivalUntil" content="2027-03-12T12:00:00-08:00"/>
<div itemprop="carrier" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="FedEx"/>
</div>
<div itemprop="itemShipped" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="Google Chromecast"/>
</div>
<div itemprop="partOfOrder" itemscope itemtype="http://schema.org/Order">
<meta itemprop="orderNumber" content="176057"/>
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Bob Dole"/>
</div>
</div>
</div>
配送情報を含む荷物の配達
詳細な配送情報を含む荷物の配達の例:
JSON-LD
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "ParcelDelivery",
"deliveryAddress": {
"@type": "PostalAddress",
"name": "John Frank",
"streetAddress": "24 Willie Mays Plaza",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"addressCountry": "US",
"postalCode": "94107"
},
"originAddress": {
"@type": "PostalAddress",
"name": "John Frank",
"streetAddress": "25 Willie Mays Plaza",
"addressLocality": "San Francisco",
"addressRegion": "CA",
"addressCountry": "US",
"postalCode": "94107"
},
"expectedArrivalFrom": "2027-03-10T12:00:00-08:00",
"expectedArrivalUntil": "2027-03-12T12:00:00-08:00",
"carrier": {
"@type": "Organization",
"name": "FedEx",
"url": "http://fedex.com/"
},
"itemShipped": {
"@type": "Product",
"name": "iPod Mini",
"url": "http://apple.com/ipad32gb",
"image": "http://apple.com/images/ipad32gb.jpg",
"sku": "B00DR0PDNE",
"description": "iPod Mini 32Gb White",
"brand": {
"@type": "Brand",
"name": "Apple"
},
"color": "white"
},
"trackingNumber": "3453291231",
"trackingUrl": "http://fedex.com/track/3453291231",
"potentialAction": {
"@type": "TrackAction",
"url": "http://fedex.com/track/3453291231"
},
"hasDeliveryMethod": {
"@type": "ParcelService",
"name": "http://schema.org/ParcelService"
},
"partOfOrder": {
"@type": "Order",
"orderNumber": "176057",
"merchant": {
"@type": "Organization",
"name": "Bob Dole",
"sameAs": "http://www.freebase.com/m/0fhkx"
},
"orderStatus": "http://schema.org/OrderInTransit"
}
}
</script>
microdata
<div itemscope itemtype="http://schema.org/ParcelDelivery">
<div itemprop="deliveryAddress" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="name" content="John Frank"/>
<meta itemprop="streetAddress" content="24 Willie Mays Plaza"/>
<meta itemprop="addressLocality" content="San Francisco"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="addressCountry" content="US"/>
<meta itemprop="postalCode" content="94107"/>
</div>
<div itemprop="originAddress" itemscope itemtype="http://schema.org/PostalAddress">
<meta itemprop="name" content="John Frank"/>
<meta itemprop="streetAddress" content="25 Willie Mays Plaza"/>
<meta itemprop="addressLocality" content="San Francisco"/>
<meta itemprop="addressRegion" content="CA"/>
<meta itemprop="addressCountry" content="US"/>
<meta itemprop="postalCode" content="94107"/>
</div>
<meta itemprop="expectedArrivalFrom" content="2027-03-10T12:00:00-08:00"/>
<meta itemprop="expectedArrivalUntil" content="2027-03-12T12:00:00-08:00"/>
<div itemprop="carrier" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="FedEx"/>
<link itemprop="url" href="http://fedex.com/"/>
</div>
<div itemprop="itemShipped" itemscope itemtype="http://schema.org/Product">
<meta itemprop="name" content="iPod Mini"/>
<link itemprop="url" href="http://apple.com/ipad32gb"/>
<link itemprop="image" href="http://apple.com/images/ipad32gb.jpg"/>
<meta itemprop="sku" content="B00DR0PDNE"/>
<meta itemprop="description" content="iPod Mini 32Gb White"/>
<div itemprop="brand" itemscope itemtype="http://schema.org/Brand">
<meta itemprop="name" content="Apple"/>
</div>
<meta itemprop="color" content="white"/>
</div>
<meta itemprop="trackingNumber" content="3453291231"/>
<link itemprop="trackingUrl" href="http://fedex.com/track/3453291231"/>
<div itemprop="potentialAction" itemscope itemtype="http://schema.org/TrackAction">
<link itemprop="url" href="http://fedex.com/track/3453291231"/>
</div>
<div itemprop="hasDeliveryMethod" itemscope itemtype="http://schema.org/ParcelService">
<meta itemprop="name" content="http://schema.org/ParcelService"/>
</div>
<div itemprop="partOfOrder" itemscope itemtype="http://schema.org/Order">
<meta itemprop="orderNumber" content="176057"/>
<div itemprop="merchant" itemscope itemtype="http://schema.org/Organization">
<meta itemprop="name" content="Bob Dole"/>
<link itemprop="sameAs" href="http://www.freebase.com/m/0fhkx"/>
</div>
<link itemprop="orderStatus" href="http://schema.org/OrderInTransit"/>
</div>
</div>
マークアップをテスト
メール マークアップ テスターツールを使用して、マークアップを検証できます。 マークアップ コードを貼り付けて [検証] ボタンをクリックすると、コンテンツがスキャンされ、エラーがある場合はレポートが生成されます。
仕様
次の表に、このタイプで使用可能なすべてのプロパティを示します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| deliveryAddress | PostalAddress | (必須 )宛先アドレス。 |
| deliveryAddress.name | テキスト | PostalAddress の名前。 |
| deliveryAddress.streetAddress | テキスト | (必須 )番地。例: 1600 Amphitheatre Pkwy |
| deliveryAddress.addressLocality | テキスト | (必須 )地名。例: Mountain View |
| deliveryAddress.addressRegion | テキスト | (必須 )リージョン。例: CA |
| deliveryAddress.addressCountry | テキストまたは国 | (必須 )国。例: USAISO 3166-1 alpha-2 の 2 文字の国コードを指定することもできます。 |
| deliveryAddress.postalCode | テキスト | (必須 )郵便番号。例: 94043 |
| originAddress | PostalAddress | 配送業者の住所。 |
| originAddress.name | テキスト | PostalAddress の名前。 |
| originAddress.streetAddress | テキスト | 番地。例: 1600 Amphitheatre Pkwy |
| originAddress.addressLocality | テキスト | 地名。例: Mountain View |
| originAddress.addressRegion | テキスト | リージョン。例: CA |
| originAddress.addressCountry | テキストまたは国 | 国。例: USAISO 3166-1 alpha-2 の 2 文字の国コードを指定することもできます。 |
| originAddress.postalCode | テキスト | 郵便番号。例: 94043 |
| expectedArrivalFrom | DateTime | 荷物が到着する予定の最も早い日付。 |
| expectedArrivalUntil | DateTime | (必須 )荷物が到着する予定の最も遅い日付。 |
| carrier | 組織 | (必須 )荷物の配達を担当する組織。文字列(「FedEx」など)も使用できます。 |
| carrier.name | テキスト | (必須 )組織の名前。 |
| carrier.url | URL | 組織の URL。 |
| itemShipped | 商品または予約 | (必須 )この配送に含まれる商品。数量を表すには、Product を適切に繰り返すか、この属性を使用せずに partOfOrder を使用して、含まれる Product を表します。オブジェクトの配列も使用できます。 |
| itemShipped.name | テキスト | (必須 )Product の名前。 |
| itemShipped.url | URL | (確認カード/検索回答に推奨 )商品の URL。通常は、販売者のウェブサイトの商品のランディング ページです。 |
| itemShipped.image | URL | (確認カード/検索回答に推奨 )Product の画像の URL。通常は、販売者のウェブサイトの画像です。 |
| itemShipped.sku | テキスト | (確認カード/検索回答に推奨 )最小管理単位(SKU)。つまり、商品またはサービス、またはオファーが参照する商品を表す販売者固有の識別子です。 |
| itemShipped.description | テキスト | Product の簡単な説明。 |
| itemShipped.brand | ブランド | Product に関連付けられているブランド。 |
| itemShipped.brand.name | テキスト | ブランド名。 |
| itemShipped.color | テキスト | 商品の色。 |
| trackingNumber | テキスト | (確認カード/検索回答に推奨 )配送業者の荷物追跡番号。 |
| trackingUrl | URL | (確認カード/検索回答に推奨 )荷物を追跡できるウェブページ。 |
| hasDeliveryMethod | DeliveryMethod | 配送に使用される方法。 |
| deliveryStatus | DeliveryEvent | 荷物が配送の各段階(発送から最終配達まで)を通過するたびに、新しいエントリが追加されます。特に、店舗受け取りやロッカー受け取りなどの受け取り型の配送に便利です。 |
| partOfOrder | 注文 | (必須 )配送される注文の詳細。itemShipped で配送に含まれる Product の詳細(配送数量など)を表すことができない場合は、この Order を使用して Product を表します。 |
| partOfOrder.orderNumber | テキスト | (必須 )取引を表す販売者固有の識別子。 |
| partOfOrder.merchant | 組織または個人 | (必須 )注文を受ける組織(例: Amazon.com は多くの販売者の販売者です)。文字列(「Bob Dole」など)も使用できます。 |
| partOfOrder.merchant.name | テキスト | (必須 )組織の名前。 |
| partOfOrder.merchant.sameAs | URL | 販売者の Freebase URL。 |
| partOfOrder.orderStatus | OrderStatus | (確認カード/検索回答に推奨 )注文の現在のステータス。 |