إجراء الطلب

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

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

ترتيب أساسي

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

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. (اسم التاجر) النص (مطلوب) اسم المؤسسة.
merchant.sameAs عنوان URL عنوان URL Freebase الخاص بالتاجر
رقم الطلب النص (مطلوب) المعرّف الخاص بالتاجر والخاص بالمعاملة.
priceCurrency النص (مطلوب) العملة (بالتنسيق ISO 4217 المكون من 3 أحرف) لسعر الطلب.
السعر رقم أو نص (مطلوب) السعر الإجمالي للمعاملة بأكملها.
عرض مقبول العرض (مطلوبة) تشتمل العروض على الطلب. يقبل أيضًا مجموعة من العناصر.
acceptedOffer.itemOffered المنتج أو الحجز (مطلوبة) السلعة التي يتم بيعها.
acceptedOffer.itemOffered.الاسم النص (مطلوبة) تمثل هذه الخاصية اسم المنتج.
acceptedOffer.itemOffered.sku النص (يُنصح باستخدامها مع بطاقات التأكيد/إجابات البحث) وحدة الاحتفاظ بالمخزون (SKU)، أي معرّف التاجر الخاص بمنتج أو خدمة، أو المنتج الذي يشير إليه العرض.
acceptedOffer.itemOffered.عنوان URL عنوان URL (يُنصح باستخدامها مع بطاقات التأكيد/إجابات البحث) عن المنتج، وتكون عادةً الصفحة المقصودة للمنتج على الموقع الإلكتروني للتاجر.
acceptedOffer.itemOffered.صورة عنوان URL (يُنصح باستخدامها مع بطاقات التأكيد/الإجابات في "بحث Google") عنوان URL لصورة المنتج وتكون عادةً صورة على الموقع الإلكتروني للتاجر.
acceptedOffer.itemOffered.اللون النص لون المنتج.
acceptedOffer.price (السعر) رقم أو نص (مطلوبة) هي سعر الوحدة للمنتج.
acceptedOffer.priceCurrency النص (مطلوبة) تمثل هذه الخاصية العملة (بتنسيق ISO 4217 المُكوَن من 3 أحرف) للسعر.
acceptedOffer. QualQuantity QuantitativeValue (مطلوب) الفاصل الزمني ووحدة قياس كميات الطلب التي تكون مواصفات العرض أو السعر صالحة لها.
acceptedOffer.ELIGIBLEQuantity.القيمة الرقم (مطلوبة) تمثّل قيمة سمة المنتج.
acceptedOffer.priceSpecification PriceSpecification واحد أو أكثر من مواصفات السعر التفصيلية التي تشير إلى سعر الوحدة ورسوم التسليم أو الدفع.
acceptedOffer.priceSpecification.السعر رقم أو نص السعر الإجمالي للمعاملة بأكملها.
acceptedOffer.priceSpecification.priceCurrency. النص العملة (بتنسيق ISO 4217 ذات الأحرف الثلاثة) لسعر الطلب.
acceptedOffer.itemCondition OfferItemCondition وصف نصي لحالة المنتج أو الخدمة أو المنتجات أو الخدمات المضمّنة في العرض.
acceptedOffer.بائع Organization أو Person الجهة التي تم تقديم الطلب إليها تقبل أيضًا سلسلة (مثل "").
acceptedOffer.seller.الاسم النص اسم المؤسسة.
priceSpecification PriceSpecification (يُنصح باستخدامها مع بطاقات التأكيد/إجابات البحث) أي بدائل أكثر تفصيلاً عن price/priceCurrency. ويُستخدم أيضًا لتحديد رسوم التسليم والضرائب. يقبل أيضًا مجموعة من العناصر.
عنوان url عنوان URL (يُنصح باستخدامها مع بطاقات التأكيد/إجابات البحث) عنوان URL للطلب، وعادةً ما يكون رابطًا إلى الموقع الإلكتروني للتاجر حيث يمكن للمستخدم استرداد تفاصيل إضافية حول طلب معيّن.
حالة الطلب OrderStatus (يُنصح باستخدامها مع بطاقات التأكيد/إجابات البحث) الحالة الحالية للطلب.
طريقة الدفع طريقة الدفع اسم بطاقة الائتمان أو طريقة دفع أخرى للطلب.
معرّف طريقة الدفع النص معرّف لطريقة الدفع المستخدمة (على سبيل المثال، الأرقام الأربعة الأخيرة من بطاقة الائتمان).
تاريخ الطلب DateTime تاريخ تقديم الطلب.
قيمة الهدية منطقي هل تمّ قبول العرض كهدية لمستخدم غير المشتري.
خصم رقم أو نص يتم تطبيق أي خصم.
سعر الصرف المخفض النص تمثّل هذه السمة العملة (بالتنسيق ISO 4217 المُكوَن من 3 أحرف) للخصم.
العميل Person أو Organization حفلة تقديم الطلب.
customer.الاسم النص اسم الشخص.
عنوان إرسال الفواتير العنوان البريدي عنوان إرسال الفواتير للطلب.
billingAddress.الاسم النص اسم العنوان البريدي.
billingAddress.streetAddress النص تمثّل هذه السمة عنوان الشارع. على سبيل المثال، 1600 Amphitheatre Pkwy.
billingAddress.addressLocality النص تمثّل هذه السمة المنطقة المحلية. على سبيل المثال، ماونتن فيو.
billingAddress.addressRegion النص تمثّل هذه السمة المنطقة. على سبيل المثال، CA.
billingAddress.addressCountry نص أو بلد البلد. على سبيل المثال، مصر. يمكنك أيضًا تقديم رمز البلد المكوّن من حرفين حسب المعيار ISO 3166-1 alpha-2.