طلب

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

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

طلب أساسي

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

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