الطلب

الطلب هو تأكيد لمعاملة (إيصال)، ويمكن أن يحتوي على عناصر متعدّدة، يمثّل كل منها 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.