الطلب هو تأكيد على المعاملة (إيصال)، ويمكن أن يحتوي على عناصر متعددة، يمثل كل منها عرضًا قبِله العميل.
حالات الاستخدام
ترتيب أساسي
مثال بسيط على طلب معيّن
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. (اسم التاجر) | النص | (مطلوب) اسم المؤسسة. |
merchant.sameAs | عنوان URL | عنوان URL Freebase الخاص بالتاجر |
رقم الطلب | النص | (مطلوب) المعرّف الخاص بالتاجر والخاص بالمعاملة. |
priceCurrency | النص | (مطلوب) العملة (بالتنسيق ISO 4217 المكون من 3 أحرف) لسعر الطلب. |
السعر | رقم أو نص | (مطلوب) السعر الإجمالي للمعاملة بأكملها. |
عرض مقبول | العرض | (مطلوبة) تشتمل العروض على الطلب. يقبل أيضًا مجموعة من العناصر. |
acceptedOffer.itemOffered | المنتج أو الحجز | (مطلوبة) السلعة التي يتم بيعها. |
acceptedOffer.itemOffered.الاسم | النص | (مطلوبة) تمثل هذه الخاصية اسم المنتج. |
acceptedOffer.itemOffered.sku | النص | (يُنصح باستخدامها مع بطاقات التأكيد/إجابات البحث) وحدة الاحتفاظ بالمخزون (SKU)، أي معرّف التاجر الخاص بمنتج أو خدمة، أو المنتج الذي يشير إليه العرض. |
acceptedOffer.itemOffered.عنوان URL | عنوان URL | (يُنصح باستخدامها مع بطاقات التأكيد/إجابات البحث) عن المنتج، وتكون عادةً الصفحة المقصودة للمنتج على الموقع الإلكتروني للتاجر. |
acceptedOffer.itemOffered.صورة | عنوان URL | (يُنصح باستخدامها مع بطاقات التأكيد/الإجابات في "بحث Google") عنوان URL لصورة المنتج وتكون عادةً صورة على الموقع الإلكتروني للتاجر. |
acceptedOffer.itemOffered.اللون | النص | لون المنتج. |
acceptedOffer.price (السعر) | رقم أو نص | (مطلوبة) هي سعر الوحدة للمنتج. |
acceptedOffer.priceCurrency | النص | (مطلوبة) تمثل هذه الخاصية العملة (بتنسيق ISO 4217 المُكوَن من 3 أحرف) للسعر. |
acceptedOffer. QualQuantity | QuantitativeValue | (مطلوب) الفاصل الزمني ووحدة قياس كميات الطلب التي تكون مواصفات العرض أو السعر صالحة لها. |
acceptedOffer.ELIGIBLEQuantity.القيمة | الرقم | (مطلوبة) تمثّل قيمة سمة المنتج. |
acceptedOffer.priceSpecification | PriceSpecification | واحد أو أكثر من مواصفات السعر التفصيلية التي تشير إلى سعر الوحدة ورسوم التسليم أو الدفع. |
acceptedOffer.priceSpecification.السعر | رقم أو نص | السعر الإجمالي للمعاملة بأكملها. |
acceptedOffer.priceSpecification.priceCurrency. | النص | العملة (بتنسيق ISO 4217 ذات الأحرف الثلاثة) لسعر الطلب. |
acceptedOffer.itemCondition | OfferItemCondition | وصف نصي لحالة المنتج أو الخدمة أو المنتجات أو الخدمات المضمّنة في العرض. |
acceptedOffer.بائع | Organization أو Person | الجهة التي تم تقديم الطلب إليها تقبل أيضًا سلسلة (مثل ""). |
acceptedOffer.seller.الاسم | النص | اسم المؤسسة. |
priceSpecification | PriceSpecification | (يُنصح باستخدامها مع بطاقات التأكيد/إجابات البحث) أي بدائل أكثر تفصيلاً عن price/priceCurrency. ويُستخدم أيضًا لتحديد رسوم التسليم والضرائب. يقبل أيضًا مجموعة من العناصر. |
عنوان url | عنوان URL | (يُنصح باستخدامها مع بطاقات التأكيد/إجابات البحث) عنوان URL للطلب، وعادةً ما يكون رابطًا إلى الموقع الإلكتروني للتاجر حيث يمكن للمستخدم استرداد تفاصيل إضافية حول طلب معيّن. |
حالة الطلب | OrderStatus | (يُنصح باستخدامها مع بطاقات التأكيد/إجابات البحث) الحالة الحالية للطلب. |
طريقة الدفع | طريقة الدفع | اسم بطاقة الائتمان أو طريقة دفع أخرى للطلب. |
معرّف طريقة الدفع | النص | معرّف لطريقة الدفع المستخدمة (على سبيل المثال، الأرقام الأربعة الأخيرة من بطاقة الائتمان). |
تاريخ الطلب | DateTime | تاريخ تقديم الطلب. |
قيمة الهدية | منطقي | هل تمّ قبول العرض كهدية لمستخدم غير المشتري. |
خصم | رقم أو نص | يتم تطبيق أي خصم. |
سعر الصرف المخفض | النص | تمثّل هذه السمة العملة (بالتنسيق ISO 4217 المُكوَن من 3 أحرف) للخصم. |
العميل | Person أو Organization | حفلة تقديم الطلب. |
customer.الاسم | النص | اسم الشخص. |
عنوان إرسال الفواتير | العنوان البريدي | عنوان إرسال الفواتير للطلب. |
billingAddress.الاسم | النص | اسم العنوان البريدي. |
billingAddress.streetAddress | النص | تمثّل هذه السمة عنوان الشارع. على سبيل المثال، 1600 Amphitheatre Pkwy. |
billingAddress.addressLocality | النص | تمثّل هذه السمة المنطقة المحلية. على سبيل المثال، ماونتن فيو. |
billingAddress.addressRegion | النص | تمثّل هذه السمة المنطقة. على سبيل المثال، CA. |
billingAddress.addressCountry | نص أو بلد | البلد. على سبيل المثال، مصر. يمكنك أيضًا تقديم رمز البلد المكوّن من حرفين حسب المعيار ISO 3166-1 alpha-2. |