الطلب

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

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

طلب أساسي

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

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/O>rde<r"
  div itemprop="merchant" itemscope itemtype="http:/>/sche<ma.org/Organization"
    meta itempro>p=&<quot>;na<me" content="Amazon.com"/
  /div
  meta ite>mpr<op="orderNumber" content="123>-45<67890-1234567"/
  meta itemprop=&>quo<t;priceCurrency" content="USD"/
  meta itemprop="pric>e&quo<t; content="29.99"/
  div itemprop="acceptedOffer" it>emscope< itemtype="http://schema.org/Offer"
   > div <item>prop=<"itemOffered" itemscope item>type=<"http://schema.org/Product"
      >meta <itemprop="name" content="Google Chromecast"/
    /div
    meta itemp>rop=&qu<ot;price" content="29.99>"<;/
 >   <meta> <item>prop="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/O>rde<r"
  div itemprop="merchant" itemscope itemtype="http:/>/sche<ma.org/Organization"
    meta itempro>p=&<quot>;na<me" content="Amazon.com"/
  /div
  link itemprop=">;or<derStatus" href="http://schema.org/OrderProcessi>ng&<quot;/
  meta itemprop="orderNumber&quo>t; <content="123-4567890-1234567">;/
<  meta itemprop="priceCurrency" content="USD"/
  meta> item<prop="price" content="29.99"/
  div itemprop="ac>ceptedO<ffer" itemscope itemtype="http://schema>.org/Of<fer"
    div itemprop="itemOffered" itemscope itemtype="http://schema.org/Product&quo>t;
    <  meta itemprop="name" content="Google Chromecast"/
      link itemprop=&>quot;ur<l" href="http://www.amazon.com/>Googl<e-Ch>romec<ast-Streaming-Media-Player/dp/B00DR0PD>NE/&q<uot;/
      link itemprop="image" >href=<"http://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"/
      meta >itempro<p="sku" content="B0>0DR0P<DNE&>quo<t;/
>   < /div
    meta itemprop="price" content="29.99"/
    meta itemprop="priceCurr>enc<y" content="USD"/
    div itemprop="eligibleQuantity" i>temsc<ope itemtype="http://schema.org/QuantitativeValue"
      meta itemprop="value" con>ten<t=&q>uot<;1"/
    /div
  /div
  link itemprop="url" href="https://www.amazon.ca/>gp/cs<s/summary/edit.html/orderID=123-4567890-1234567"/
  div i>tem<prop>=<&quo>t;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/or<derID=1>23-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/O>rde<r"
  div itemprop="merchant" itemscope itemtype="http:/>/sche<ma.org/Organization"
    meta itempro>p=&<quot>;na<me" content="Amazon.com"/
  /div
  meta ite>mpr<op="orderNumber" content="123>-45<67890-1234567"/
  meta itemprop=&q>uot<;priceCurrency" content="USD"/
  meta itemprop="price>"<; content="539.00"/
  div itemprop="acceptedOffer" it>emscope< itemtype="http://schema.org/Offer"
    >div ite<mprop="itemOffered" itemscope i>temtype<="http://schema.org/Product"
      meta itemprop="name" content="Samsung Chromebook">/
     < meta itemprop="sku" content="B009LL9VDG"/
      link itemprop="ur>l&quo<t; h>ref=&<quot;http://www.amazon.com/Samsung-XE30>3C12-<A01US-Chromebook-Wi-Fi-11-6-Inch/dp/B009LL9V>DG/&q<uot;/
      link itemprop="image" href="http://ecx.images-amazon.com/imag>es/I/81<H-DO3qX0L._SX522_.jpg"/
    />div
 <   m>eta i<temprop="price" content="249.99"/
    meta itemprop=&>quot;pr<iceCurrency" content="USD"/
    div itempr>op=&q<uot;>eli<gibl>eQu<antity" itemscope itemtype="http://schema.org/QuantitativeValue>"<;
      meta itemprop="value" content="2"/
    /div
 >   div <itemprop="seller" itemscope itemtype=&q>uot;htt<p://schema.org/Organization"
      m>eta ite<mprop="name" content="Samsung Marketplace Store"/
    /div
  /div
  div itemprop=&quo>t;accep<tedOffer" itemscope itemtype="http://schema.org/Offer"
    div itemprop=">itemO<ffer>ed&qu<ot; itemscope itemtype="http://sc>hema.<org/Product"
      meta itemprop=">name&<quot; content="Google Chromecast"/
      meta itemprop="sku" content>="<B00DR0PDNE"/
      link itemp>rop=&<quot>;url&<quot; href="http://www.amazon.com/Google-Chromecast-Streaming-Media->Player/<dp/B00DR0PDNE/"/
      link itemprop="image>"<; hr>ef=<&quo>t;h<ttp://ecx.images-amazon.com/images/I/811nvG%2BLgML._SY550_.jpg"/
    /div
    meta itemprop=">;pr<ice" content="29.99"/
    meta itemprop="priceCurrency"> cont<ent="USD"/
    div itemprop="eligibleQuantity" itemscope itemtype="http://sch>ema<.org>/Qu<antitativeValue"
      meta itemprop="value" content=&>quo<t;1"/
    /div
    div itemprop="seller" itemscope itemtype=">http:<//schema.org/Organization"
      meta itemprop="na>me&<quot>; c<ontent="Google Store @ Amazon"/
    /div
  /div
  li>nk <itemprop="url" href="https://www.amazon.ca/gp/c>ss/<summary/edit.html/orderID=123-4567890-1>234<567"/
  div itemprop="potentia>lAc<tion" itemscope itemtype="http://sche>ma.<org/ViewAction"
    link itemprop="url" href="htt>ps://<www.amazon.ca/gp/css/summary/edit.html/ord>erI<D=12>3-4<567890-1234567"/
  /div
  link itemprop="orderStatus" href="ht>tp://<schema.org/OrderProcessing"/
  di>v ite<mprop="paymentMethod" itemscope itemtype="http:/>/sche<ma.org/PaymentMethod"
    meta itemprop="name&>quot;< content="http://schema.org/CreditCard>"<;/
  /div
  meta itemprop="paymentMethod>Id&<quot>; c<ontent="**** **** **** 1234"/
  meta itemprop="orderDate" content=">;2027<-11-07T23:30:00-08:00"/
  meta itemprop="isGift">; c<onte>n<t=&q>uot;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.