الطلب

الطلب هو تأكيد للمعاملة (إيصال)، والذي يمكن أن يحتوي على عدة بنود، كل منها ممثل بـ 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 (required) الطرف الذي يتلقى الطلب (على سبيل المثال، Amazon.com هو تاجر للعديد من البائعين). يقبل أيضًا سلسلة نصية (مثل "Amazon.com").
تاجر.اسم نص (required) اسم المنظمة.
تاجر.نفس الشيء عنوان URL رابط Freebase الخاص بالتاجر.
orderNumber نص (required) المعرف الخاص بالتاجر للمعاملة.
priceCurrency نص (required) العملة (بتنسيق ISO 4217 المكون من 3 أحرف) لسعر الطلب.
price رقم أو نص (مطلوبة) تمثّل هذه السمة السعر الإجمالي للمعاملة بأكملها.
acceptedOffer العرض الترويجي (required) العروض المضمنة في الطلب. تقبل هذه السمة أيضًا مصفوفة من العناصر.
العرض المقبول.المنتج المعروض المنتج أو الحجز (required) السلعة المعروضة للبيع.
acceptedOffer.itemOffered.name نص (required) اسم المنتج.
acceptedOffer.itemOffered.sku نص (recommended for confirm cards/Search Answers) وحدة حفظ المخزون (SKU)، أي معرف خاص بالتاجر لمنتج أو خدمة، أو المنتج الذي يشير إليه العرض.
acceptedOffer.itemOffered.url عنوان URL (recommended for confirm cards/Search Answers) عنوان URL للمنتج، وعادةً ما يكون صفحة المنتج المقصودة على موقع التاجر الإلكتروني.
acceptedOffer.itemOffered.image عنوان URL (يُنصح به لبطاقات التأكيد/إجابات "بحث Google") عنوان URL لصورة المنتج، وعادةً ما تكون صورة على الموقع الإلكتروني للتاجر
acceptedOffer.itemOffered.color نص لون المنتج.
العرض المقبول.السعر رقم أو نص (required) سعر الوحدة للمنتج.
acceptedOffer.priceCurency نص (required) العملة (بتنسيق ISO 4217 المكون من 3 أحرف) للسعر.
العرض المقبول.الكمية المؤهلة QuantitativeValue (required) الفترة ووحدة قياس كميات الطلب التي يكون العرض أو مواصفات السعر صالحة لها.
acceptedOffer.eligibleQuantity.value العدد (required) قيمة خاصية المنتج.
تم قبول العرض. مواصفات السعر PriceSpecification مواصفات سعرية واحدة أو أكثر مفصلة، ​​توضح سعر الوحدة ورسوم التوصيل أو الدفع.
acceptedOffer.priceSpecification.price رقم أو نص تمثّل هذه السمة السعر الإجمالي للمعاملة بأكملها.
acceptedOffer.priceSpecification.priceCurrency نص العملة (بتنسيق ISO 4217 المكون من 3 أحرف) لسعر الطلب.
acceptedOffer.itemCondition OfferItemCondition وصف نصي لحالة المنتج أو الخدمة، أو المنتجات أو الخدمات المشمولة في العرض.
acceptedOffer.seller Organization أو Person الجهة التي تم تقديم الطلب إليها. يقبل أيضًا سلسلة (مثل "").
acceptedOffer.seller.name نص اسم المنظمة.
priceSpecification PriceSpecification (recommended for confirm cards/Search Answers) أي بدائل أكثر تفصيلاً لـ price/priceCurrency. تُستخدَم أيضًا لتحديد رسوم الضريبة والتسليم. تقبل هذه السمة أيضًا مصفوفة من العناصر.
url عنوان URL (recommended for confirm cards/Search Answers) عنوان URL للطلب، وهو عادةً رابط لموقع التاجر الإلكتروني حيث يمكن للمستخدم استرداد المزيد من التفاصيل حول الطلب.
orderStatus OrderStatus (recommended for confirm cards/Search Answers) الحالة الحالية للطلب.
paymentMethod PaymentMethod اسم بطاقة الائتمان أو طريقة الدفع الأخرى المستخدمة في الطلب
paymentMethodId نص معرّف لطريقة الدفع المستخدَمة (مثل آخر 4 أرقام من بطاقة الائتمان)
orderDate DateTime تاريخ تقديم الطلب.
isGift منطقي هل تم قبول العرض كهدية لشخص آخر غير المشتري؟
discount رقم أو نص تم تطبيق أي خصم.
discountCurrency نص عملة الخصم (بصيغة ISO 4217 المكونة من 3 أحرف).
العميل شخص أو منظمة الطرف الذي قام بتقديم الطلب.
customer.name نص اسم الشخص
billingAddress PostalAddress عنوان إرسال الفاتورة للطلب.
billingAddress.name نص اسم العنوان البريدي.
billingAddress.streetAddress نص تمثّل هذه السمة عنوان الشارع. على سبيل المثال، 1600 Amphitheatre Pkwy.
billingAddress.addressLocality نص تمثّل هذه السمة المنطقة المحلية. على سبيل المثال، ماونتن فيو.
عنوان الفوترة.منطقة العنوان نص تمثّل هذه السمة المنطقة. على سبيل المثال، كاليفورنيا.
billingAddress.addressCountry نص أو البلد البلد. على سبيل المثال، الولايات المتحدة الأمريكية. يمكنك أيضًا تقديم رمز الدولة المكون من حرفين وفقًا لمعيار ISO 3166-1 alpha-2.