الطلب هو تأكيد لمعاملة (إيصال)، ويمكن أن يحتوي على
عناصر متعدّدة، يمثّل كل منها 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>
البيانات الجزئية
<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. للربط مباشرةً بتطبيق على الأجهزة الجوّالة، أضِف أيضًا 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 | عنوان URL | عنوان URL الخاص بالتاجر على Freebase |
| orderNumber | نص | (مطلوبة) معرِّف المعاملة الخاص بالتاجر |
| priceCurrency | نص | (مطلوبة) عملة سعر الطلب (بالتنسيق ISO 4217 المُكوَن من 3 أحرف) |
| price | العدد أو نص | (مطلوبة) إجمالي سعر المعاملة بالكامل |
| acceptedOffer | العرض الترويجي | (مطلوبة) العروض الترويجية المضمّنة في الطلب يقبل هذا الموقع أيضًا مصفوفة من العناصر. |
| acceptedOffer.itemOffered | المنتج أو الحجز | (مطلوبة) السلعة التي يتم بيعها |
| acceptedOffer.itemOffered.name | نص | (مطلوبة) اسم المنتج |
| acceptedOffer.itemOffered.sku | نص | (مُقترَحة لبطاقات التأكيد/إجابات "بحث Google") رمز التخزين التعريفي (SKU)، أي معرِّف خاص بالتاجر لمنتج أو خدمة، أو المنتج الذي يشير إليه العرض الترويجي |
| acceptedOffer.itemOffered.url | عنوان URL | (مُقترَحة لبطاقات التأكيد/إجابات "بحث Google") عنوان URL للمنتج، وعادةً ما يكون الصفحة المقصودة الخاصة بالمنتج على الموقع الإلكتروني للتاجر |
| acceptedOffer.itemOffered.image | عنوان URL | (مُقترَحة لبطاقات التأكيد/إجابات "بحث Google") عنوان URL لصورة المنتج، وعادةً ما تكون صورة على الموقع الإلكتروني للتاجر |
| acceptedOffer.itemOffered.color | نص | لون المنتج |
| acceptedOffer.price | العدد أو نص | (مطلوبة) سعر الوحدة للمنتج |
| acceptedOffer.priceCurrency | نص | (مطلوبة) عملة السعر (بالتنسيق ISO 4217 المُكوَن من 3 أحرف) |
| acceptedOffer.eligibleQuantity | QuantitativeValue | (مطلوبة) الفترة الزمنية ووحدة قياس كميات الطلب التي يكون العرض الترويجي أو مواصفات السعر صالحًا لها |
| acceptedOffer.eligibleQuantity.value | العدد | (مطلوبة) قيمة سمة المنتج |
| acceptedOffer.priceSpecification | PriceSpecification | مواصفات سعر مفصّلة واحدة أو أكثر، تشير إلى سعر الوحدة ورسوم التوصيل أو الدفع |
| acceptedOffer.priceSpecification.price | العدد أو نص | إجمالي سعر المعاملة بالكامل |
| acceptedOffer.priceSpecification.priceCurrency | نص | عملة سعر الطلب (بالتنسيق ISO 4217 المُكوَن من 3 أحرف) |
| acceptedOffer.itemCondition | OfferItemCondition | وصف نصي لحالة المنتج أو الخدمة، أو المنتجات أو الخدمات المضمّنة في العرض الترويجي |
| acceptedOffer.seller | Organization أو Person | الجهة التي تم تقديم الطلب إليها يقبل هذا الموقع أيضًا سلسلة (مثل ""). |
| acceptedOffer.seller.name | نص | اسم المؤسسة |
| priceSpecification | PriceSpecification | (مُقترَحة لبطاقات التأكيد/إجابات "بحث Google") أي بدائل أكثر تفصيلاً للسعر/priceCurrency تُستخدَم أيضًا لتحديد الضرائب ورسوم التوصيل يقبل هذا الموقع أيضًا مصفوفة من العناصر. |
| url | عنوان URL | (مُقترَحة لبطاقات التأكيد/إجابات "بحث Google") عنوان URL للطلب، وعادةً ما يكون رابطًا إلى الموقع الإلكتروني للتاجر حيث يمكن للمستخدم استرداد مزيد من التفاصيل حول الطلب |
| orderStatus | OrderStatus | (مُقترَحة لبطاقات التأكيد/إجابات "بحث Google") الحالة الحالية للطلب |
| paymentMethod | PaymentMethod | اسم بطاقة الائتمان أو طريقة الدفع الأخرى للطلب |
| paymentMethodId | نص | معرِّف لطريقة الدفع المُستخدَمة (مثل آخر 4 أرقام من بطاقة الائتمان) |
| orderDate | DateTime | تاريخ تقديم الطلب |
| isGift | منطقي | هل تم قبول العرض الترويجي كهدية لشخص آخر غير المشتري؟ |
| discount | العدد أو نص | أي خصم تم تطبيقه |
| discountCurrency | نص | عملة الخصم (بالتنسيق ISO 4217 المُكوَن من 3 أحرف) |
| customer | Person أو Organization | الجهة التي تقدّم الطلب |
| customer.name | نص | اسم الشخص |
| billingAddress | PostalAddress | عنوان إرسال الفواتير للطلب |
| billingAddress.name | نص | اسم PostalAddress |
| billingAddress.streetAddress | نص | تمثّل هذه السمة عنوان الشارع. على سبيل المثال، 1600 Amphitheatre Pkwy. |
| billingAddress.addressLocality | نص | تمثّل هذه السمة المنطقة المحلية. على سبيل المثال، ماونتن فيو |
| billingAddress.addressRegion | نص | تمثّل هذه السمة المنطقة. على سبيل المثال، كاليفورنيا |
| billingAddress.addressCountry | نص أو البلد | البلد على سبيل المثال، الولايات المتحدة الأمريكية يمكنك أيضًا تقديم رمز البلد المكوّن من حرفَين حسب المعيار ISO 3166-1 alpha-2. |