الطلب

الطلب هو تأكيد لإجراء معاملة (إيصال)، ويمكن أن يحتوي على عدة بنود، يمثّل كل منها عرضًا قبِله العميل.

حالات الاستخدام

الترتيب الأساسي

مثال بسيط على طلب

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