طلب

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

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

طلب أساسي

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

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.