استخدِم هذا النموذج لوصف حالة تسليم الطرود.
حالات الاستخدام
توصيل الطرود الأساسي
مثال بسيط على توصيل طرد:
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>
البيانات الجزئية
<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>
البيانات الجزئية
<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 | نص | (مطلوبة) تمثّل هذه السمة المنطقة المحلية. على سبيل المثال، ماونتن فيو. |
| deliveryAddress.addressRegion | نص | (مطلوبة) المنطقة على سبيل المثال، CA. |
| deliveryAddress.addressCountry | نص أو البلد | (مطلوبة) تشير إلى البلد. على سبيل المثال، الولايات المتحدة الأمريكية. يمكنك أيضًا تقديم رمز البلد المكوّن من حرفَين حسب المعيار ISO 3166-1 alpha-2. |
| deliveryAddress.postalCode | نص | (مطلوبة) تمثّل هذه السمة الرمز البريدي. مثلاً، 94043. |
| originAddress | PostalAddress | عنوان شركة الشحن |
| originAddress.name | نص | تمثّل هذه السمة اسم PostalAddress. |
| originAddress.streetAddress | نص | تمثّل هذه السمة عنوان الشارع. على سبيل المثال، 1600 Amphitheatre Pkwy. |
| originAddress.addressLocality | نص | تمثّل هذه السمة المنطقة المحلية. على سبيل المثال، ماونتن فيو. |
| originAddress.addressRegion | نص | تمثّل هذه السمة المنطقة. على سبيل المثال، CA. |
| originAddress.addressCountry | نص أو البلد | تمثّل هذه السمة البلد. على سبيل المثال، الولايات المتحدة الأمريكية. يمكنك أيضًا تقديم رمز البلد المكوّن من حرفَين حسب المعيار ISO 3166-1 alpha-2. |
| originAddress.postalCode | نص | تمثّل هذه السمة الرمز البريدي. مثلاً، 94043. |
| expectedArrivalFrom | DateTime | أقرب تاريخ يُتوقّع وصول الحزمة فيه |
| expectedArrivalUntil | DateTime | (مطلوبة) يشير هذا الحقل إلى آخر تاريخ يُتوقّع وصول الحزمة فيه. |
| مشغّل شبكة الجوّال | المؤسسة | (مطلوبة) الجهة المسؤولة عن تسليم الطرد. يقبل أيضًا سلسلة (مثل "FedEx"). |
| carrier.name | نص | (مطلوب) اسم المؤسسة. |
| carrier.url | عنوان URL | عنوان URL للمؤسسة. |
| itemShipped | المنتج أو الحجز | (مطلوبة) المنتجات المضمّنة في هذه الشحنة لتمثيل الكمية، كرِّر المنتج بشكل مناسب أو لا تستخدِم هذه السمة واستخدِم partOfOrder بدلاً من ذلك للتعبير عن المنتجات المضمّنة. تقبل هذه السمة أيضًا مصفوفة من العناصر. |
| itemShipped.name | نص | (مطلوبة) اسم المنتج |
| itemShipped.url | عنوان URL | (يُنصح به لبطاقات التأكيد/إجابات "بحث Google") عنوان URL الخاص بالمنتج، وهو عادةً الصفحة المقصودة للمنتج على الموقع الإلكتروني للتاجر. |
| itemShipped.image | عنوان URL | (يُنصح به لبطاقات التأكيد/إجابات "بحث Google") عنوان URL لصورة المنتج، وعادةً ما تكون صورة على الموقع الإلكتروني للتاجر |
| itemShipped.sku | نص | (يُنصح باستخدامه لبطاقات التأكيد/إجابات "بحث Google") رمز التخزين التعريفي (SKU)، أي معرّف خاص بالتاجر لمنتج أو خدمة، أو المنتج الذي يشير إليه العرض |
| itemShipped.description | نص | تمثّل هذه السمة وصفًا موجزًا للمنتج. |
| itemShipped.brand | العلامة التجارية | تمثّل هذه السمة العلامة التجارية المرتبطة بالمنتج. |
| itemShipped.brand.name | نص | اسم العلامة التجارية |
| itemShipped.color | نص | تمثّل هذه السمة لون المنتج. |
| trackingNumber | نص | (يُنصح باستخدامه لبطاقات التأكيد/إجابات "بحث Google") رقم التتبّع الخاص بشركة الشحن |
| trackingUrl | عنوان URL | (يُنصح باستخدامه مع بطاقات التأكيد/إجابات "بحث Google") صفحة الويب التي يمكن تتبُّع الحزمة فيها |
| hasDeliveryMethod | DeliveryMethod | الطريقة المستخدَمة للعرض |
| deliveryStatus | DeliveryEvent | يتمّ إضافة إدخال جديد عند مرور الحزمة بكل مرحلة من مراحل رحلتها (من الشحن إلى التسليم النهائي). مفيدة بشكل خاص لعمليات التسليم التي تتطلّب استلام الطلب (مثل الاستلام من المتجر أو من خزنة). |
| partOfOrder | طلب | (مطلوبة) تفاصيل الطلب الذي يتم شحنه. عندما لا يمكن التعبير عن تفاصيل المنتجات المضمّنة في الشحنة باستخدام itemShipped (مثل الكمية التي تم شحنها)، استخدِم هذا الطلب للتعبير عن المنتجات بدلاً من ذلك. |
| partOfOrder.orderNumber | نص | (مطلوبة) تمثّل هذه السمة معرِّف المعاملة الخاص بالتاجر. |
| partOfOrder.merchant | Organization أو Person | (مطلوبة) الجهة التي تتلقّى الطلب (مثلاً، Amazon.com هو تاجر للعديد من البائعين). يقبل أيضًا سلسلة (مثل "Bob Dole"). |
| partOfOrder.merchant.name | نص | (مطلوب) اسم المؤسسة. |
| partOfOrder.merchant.sameAs | عنوان URL | تمثّل هذه السمة عنوان URL الخاص بالتاجر على Freebase. |
| partOfOrder.orderStatus | OrderStatus | (يُنصح باستخدامه لبطاقات التأكيد/إجابات "بحث Google") الحالة الحالية للطلب. |