مخطط المستودع العلائقي

توضّح هذه الصفحة تنسيق خلاصات البيانات الشاملة للطلب (مواصفات الأغذية في كتالوج الطعام) التي تقدّمها إلى Google. للحصول على نسخة من هذه المعلومات يمكن للجهاز قراءتها، يمكنك تنزيل مخطّط JSON.

المتطلبات العامة

يجب تنظيم الكيانات لتكون في سطر واحد لكل كيان في الخلاصات (يتم فصل الكيانات بأحرف سطر جديد). لأغراض إمكانية القراءة، لا تتبع أمثلة JSON على هذه الصفحة هذا الهيكل. مع ذلك، يجب اتّباع هذه البنية عند إرسال خلاصاتك. على سبيل المثال، يجب هيكلة كيان القائمة مثل الرمز التالي:

{"@type": "Menu","name": "Coffee Shop A","@id": "1535"}

يمكن أن يكون لكل كيان في "المطعم" كيانان من عناصر الخدمة (واحد لكلّ من نوعَي الخدمة "التسليم" و"TakeOUT"). يمكن أن يحتوي كل كيان من كيانات "الخدمة" على كيان "قائمة" واحد فقط.

يمكن إعادة استخدام أي وحدات فرعية عبر مطاعم متعددة.

إرشادات قيمة JSON

فرض الكتابة

ويمكن أن يختلف نوع قيمة JSON عن النوع المحدّد في المخطط طالما أنّه يمكن فرض القيمة على النوع المطلوب. على سبيل المثال، يمكن أن تقبل خصائص السلسلة كلاً من قيم السلسلة والأعداد الصحيحة كإدخال. وبالمثل، يمكن أن تقبل سمات الأعداد الصحيحة قيمة السلسلة طالما أنّه يمكن تحليل السلسلة إلى عدد صحيح صالح.

يعمل فرض الكتابة أيضًا مع الخصائص المتكررة. يمكن للسمات المكرّرة قبول القيم كإدخال بدون وضعها بين قوسَين []. على سبيل المثال، تقبل السمة OperationHours.serviceId كلاً من "service_id" و["service_id"] كإدخالات صالحة.

قيم التاريخ والوقت

يستند النطاق DateTime إلى نوع schema.org، ويجب أن يتّبع تنسيق ISO 8601، ما لم يُذكر خلاف ذلك، ويتضمن التاريخ والوقت والمنطقة الزمنية. استخدم البنية التالية لـ DateTime:

// DateTime format:
YYYY-MM-DDTHH:MM:SS[∓HH:MM|Z]

مثال:

2017-05-01T06:30:00-07:00 // UTC minus 7 hours
2017-05-01T06:30:00Z  // UTC time zone. The optional "Z" suffix represents the UTC time zone.

Time هو الوقت المحلي للمنطقة الزمنية لمطعم أو خدمة معيّنة، ويستند أيضًا إلى نوع schema.org، ويجب أيضًا أن يتّبع تنسيق ISO 8601. يستخدم الوقت الصيغة التالية:

// Time format:
THH:MM:SS

مثال:

T08:08:00 // 8:08 AM

عليك مراعاة ما يلي عند تحديد DateTime أو Time:

  • وتكون البادئة "T" قبل الوقت جزءًا من التنسيق وهي مطلوبة.
  • يجب تحديد المنطقة الزمنية لـ DATETIME. إنها غير مطلوبة لـ TIME.
  • يجب تحديد الوقت بالتوقيت المحلي للمطعم أو الخدمة.

بيانات المطعم

المطعم (مطلوب)

تمثّل هذه السمة كيانًا مطلوبًا للتنفيذ. وصف مطعم.

يعرض الجدول التالي سمات النوع Restaurant:

الموقع النوع الوصف
@type الثابت

يجب ملء الحقل.

القيمة: Restaurant

@id String

يجب ملء الحقل.

معرّف فريد للمطعم أو مقدّم خدمة التوصيل.

مثلاً: restaurant_1

name String

يجب ملء الحقل.

اسم المطعم.

مثلاً: Foo

description String

وصف المطعم.

مثلاً: Best seafood in town

url عنوان URL

عنوان URL الذي يمثل المطعم. يُفضّل استخدام نطاق المطعم على نطاق العارض.

مثلاً: http://www.provider.com/somerestaurant

sameAs عنوان URL

الموقع الإلكتروني الرسمي للمطعم.

مثلاً: http://www.provider2.com/somerestaurant

telephone String

رقم هاتف المطعم.

مثلاً: +12345665898

streetAddress String

يجب ملء الحقل.

عنوان الشارع الذي يقع فيه المطعم.

مثلاً: 12345 Bar Avenu

addressLocality String

يجب ملء الحقل.

تمثّل هذه السمة المنطقة المحلية أو المدينة.

مثلاً: San Francisco

addressRegion String

يجب ملء الحقل.

المنطقة أو الولاية.

مثلاً: CA

postalCode String

يجب ملء الحقل.

تمثّل هذه السمة الرمز البريدي.

مثلاً: 94124

addressCountry String

يجب ملء الحقل.

رمز بلد من حرفَين وفقًا لمعيار ISO 3166-1 alpha-2.

مثلاً: US

latitude Number

خط العرض بالدرجات. تقتصر القيم على النطاق [[-90, 90]]. يجب ألا تقل الدقة عن 5 خانات عشرية.

مثلاً: 35.7392607

longitude Number

خط الطول بالدرجات. تقتصر القيم على النطاق [[-180, 180]]. يجب ألا تقل الدقة عن 5 خانات عشرية.

مثلاً: -120.3895522

dealId List<String>

يسري العرض على Deal من المطعم.

imprint String

الشركة الفرعية للمطعم هي قسم يحتوي على معلومات إضافية حول المطعم، مثل الاسم القانوني والعنوان القانوني ورقم التسجيل. يمكن تنسيق هذه المعلومات باستخدام " ".

مثلاً:

Three Brothers Tacos
123 FooSt
Mountain View
CA 94041, United States
email: contact@threebrotherstacos.com

Commercial Register: 123456789

economicOperator String

تمثّل هذه السمة معلومات عن المشغّل الاقتصادي المرتبطة بالمطعم، إذا كان ذلك منطبقًا. سيتم عرض هذه المعلومات ضمن قسم "معلومات عن السوق". يمكن تنسيق النص باستخدام " ".

مثلاً:

XYZ Corp
123 Main Street
555-555-5555

dateModified الطابع الزمني وفقًا لمعيار ISO

تاريخ ووقت آخر تعديل لخلاصة كيان في المطعم بتنسيق الطابع الزمني ISO ولكن بنوع سلسلة.

مثلاً: 2017-01-02T00:00:00-07:00

يعرض المثال التالي عنصر Restaurant:

مثال

{
  "@type": "Restaurant",
  "@id": "10824",
  "name": "Pronto Wood Fired Pizzeria",
  "url": "https://www.provider.com/pronto-wood-fired-pizzeria",
  "telephone": "+16503659978",
  "streetAddress": "2560 El Camino Real",
  "addressLocality": "Palo Alto",
  "addressRegion": "CA",
  "postalCode": "94061",
  "addressCountry": "US",
  "latitude": 37.472842,
  "longitude": -122.217144
}

صفقة

أنواع الخصومات التي يمكن تطبيقها على سلة تسوّق

يعرض الجدول التالي سمات النوع Deal:

الموقع النوع الوصف
@type الثابت

يجب ملء الحقل.

القيمة: Deal

@id String

يجب ملء الحقل.

معرّف فريد للصفقة

مثلاً: FREEDELIVERY

dealCode String

يجب ملء الحقل.

رقم تعريف الصفقة الفريد لكل صفقة لكل شريك. يجب أن يحدّد هذا المعرّف الصفقة بشكل فريد في نظام العروض الترويجية لديك. يرسل إليك محرّك بحث Google هذا المعرّف في الحقل promotions.coupon في CheckoutRequest للتحقق من صحته.

مثلاً: ADETRE23

applicableServiceType القائمة<ServiceType>

الخدمة التي تنطبق عليها هذه الصفقة. تفترض القيمة التلقائية أنّ الصفقة تنطبق على الجميع.

eligibleMaxOrders عدد صحيح

لا تكون هذه الصفقة مؤهّلة إلا عندما يكون لدى المستخدم عدد أقل من أو مساوٍ لهذا العدد من الطلبات الناجحة السابقة.

availabilityId List<String>

تمثّل هذه السمة قيم @id لعناصر مدى التوفّر التي تقدّم تفاصيل حول وقت توفّر قسم القائمة.

مثلاً: [ "availability_1" ]

isDisabled منطقية

يؤدي هذا الإجراء إلى إلغاء عمليات التحقّق الأخرى من الصلاحية.

dealType DealType

يجب ملء الحقل.

فئة الصفقة التي تريد تطبيق الخصم عليها يمكن أن تتمثل الفئة في إجمالي سلة التسوّق بالكامل أو رسوم الخدمة أو رسوم التوصيل.

priceCurrency String

مطلوبة عند discount is defined.

مطلوبة عند eligibleTransactionVolumeMin is defined.

عملة الخصم (بتنسيق ISO 4217 المكوَّن من 3 أحرف)

مثلاً: USD

eligibleTransactionVolumeMin Number

حجم المعاملات، بوحدة مالية، يكون هذا العرض الترويجي صالحًا لها

termsOfServiceUrl عنوان URL

يجب ملء الحقل.

وثائق بنود الخدمة التي يمكن للمستخدمين قراءتها

dateModified الطابع الزمني وفقًا لمعيار ISO

تاريخ ووقت آخر تعديل لخلاصة كيان الصفقة بتنسيق الطابع الزمني ISO ولكن بالنوع "سلسلة".

مثلاً: 2017-01-02T00:00:00-07:00

يجب استخدام مجموعة واحدة فقط من مجموعات المواقع الإلكترونية التالية.
discount المجموعة 1 Number

قيمة الخصم كرقم.

discountPercentage المجموعة 2 Number

قيمة الخصم كنسبة مئوية من السعر الأصلي.

يعرض المثال التالي عنصر Deal:

مثال 1

{
  "@type": "Deal",
  "@id": "ONEDOLLARFEE",
  "dealCode": "THREEDOLLARFEE",
  "dealType": "CART_OFF",
  "availabilityId": [
    "availability_may2020"
  ],
  "termsOfServiceUrl": "http://www.provider.com/onedollardeal",
  "applicableServiceType": [
    "TAKEOUT"
  ],
  "discount": 3,
  "priceCurrency": "USD"
}

مثال 2

{
  "@type": "Deal",
  "@id": "10PERCOFF",
  "dealCode": "10PERCOFF",
  "dealType": "CART_OFF",
  "availabilityId": [
    "availability_weekdays_evening"
  ],
  "termsOfServiceUrl": "http://www.provider.com/deal",
  "discountPercentage": 10,
  "priceCurrency": "USD"
}

مثال 3

{
  "@type": "Deal",
  "@id": "FREEDELIVERY",
  "dealCode": "FREEDELIVERY",
  "dealType": "DELIVERY_OFF",
  "availabilityId": [
    "availability_may"
  ],
  "applicableServiceType": [
    "DELIVERY"
  ],
  "termsOfServiceUrl": "http://www.provider.com/free_delivery_deal",
  "discountPercentage": 100,
  "eligibleTransactionVolumeMin": 25,
  "priceCurrency": "USD"
}

بيانات الخدمة

الخدمة (مطلوبة)

يصف تفاصيل خدمة طلب الطعام في مطعم. إنّ السمة Service هي كيان مطلوب لتنفيذه.

يعرض الجدول التالي سمات النوع Service:

الموقع النوع الوصف
@type الثابت

يجب ملء الحقل.

القيمة: Service

@id String

يجب ملء الحقل.

معرّف خدمة توصيل الطلبات.

مثلاً: service_1

serviceType ServiceType

يجب ملء الحقل.

تمثّل هذه السمة نوع الخدمة المقدَّمة. القيم المحتملة هي "التسليم" أو "التصدير".

مثلاً: DELIVERY

restaurantId String

يجب ملء الحقل.

القيمة @id لكيان المطعم المرتبط بكيان الخدمة هذا.

مثلاً: restaurant_1

menuId String

يجب ملء الحقل.

القيمة @id لعنصر القائمة المرتبط بكيان الخدمة هذا.

مثلاً: menu_1

dateModified الطابع الزمني وفقًا لمعيار ISO

تاريخ ووقت آخر تعديل لخلاصة كيان الخدمة بتنسيق الطابع الزمني ISO.

مثلاً: 2017-01-02T00:00:00-07:00

isDisabled منطقية

يشير إلى ما إذا كان الكيان قد تم إيقافه. لا تستخدِم هذا النوع إلا إذا كان عليك إيقاف الكيان بسبب حدث غير متوقّع ولا تعرف متى ستتم إعادة إنشاء الخدمة (على سبيل المثال، عدم الاستخدام للعطلات).

مثلاً: true

servingConfig ServingConfig

إعدادات العرض للخدمة المستخدمة للتحكّم في ميزات مختلفة، مثل إيقاف التطبيق المصغّر للعرض الترويجي وما إلى ذلك

actionLinkUrl String

يحتوي على عنوان URL لخدمة توصيل الطعام أو طلبه لتناوله خارج المطعم التي سيتم استخدامها أثناء الانتقال من تجربة طلب الطعام الشاملة إلى عملية إعادة التوجيه.

يعرض المثال التالي عنصر Service:

مثال 1

{
  "@type": "Service",
  "@id": "10824/takeout",
  "serviceType": "TAKEOUT",
  "menuId": "10824",
  "restaurantId": "10824",
  "actionLinkUrl": "https://www.rwgpartnerwebsite.com/foodorderpickup/merchant_foepa_3"
}

مثال 2

{
  "@type": "Service",
  "@id": "10824/delivery",
  "serviceType": "DELIVERY",
  "menuId": "10824",
  "restaurantId": "10824",
  "actionLinkUrl": "https://www.rwgpartnerwebsite.com/foodorderdelivery/merchant_foepa_3"
}

ServiceArea

وصف المنطقة الجغرافية التي يمكن توصيل الطعام فيها. يجب تنفيذ هذا الكيان في حال كان الكيان Service المرتبط قد تم ضبطه على القيمة "serviceType" على "التسليم".

يعرض الجدول التالي سمات النوع ServiceArea:

الموقع النوع الوصف
@type الثابت

يجب ملء الحقل.

القيمة: ServiceArea

@id String

يجب ملء الحقل.

معرّف فريد لمنطقة نطاق الخدمة

مثلاً: service_area_1

serviceId List<String>

يجب ملء الحقل.

القيمة @id لعنصر الخدمة المرتبط بكيان ServiceArea هذا.

مثلاً: [ "service_1" ]

dateModified الطابع الزمني وفقًا لمعيار ISO

تاريخ ووقت آخر تعديل لخلاصة الكيان ServiceArea بتنسيق الطابع الزمني ISO ولكن بنوع سلسلة.

مثلاً: 2017-01-02T00:00:00-07:00

exclude منطقية

استبعِد منطقة نطاق الخدمة هذه من منطقة التسليم الإجمالية. على سبيل المثال، يمكن استبعاد رمز بريدي من منطقة مضلّعة أكبر.

يجب استخدام مجموعة واحدة فقط من مجموعات المواقع الإلكترونية التالية.
polygon المجموعة 1 List<String>

مضلّع أو مضلّع متعدد المضلعات كسلسلة من ثلاث نقاط أو أكثر مفصولة بمسافات. من المستحسن أن تكون النقطتان الأولى والأخيرة متطابقتين، لكنه ليس مطلوبًا. تُحدد كل نقطة في المضلّع أو المضلّع المتعدد بنقطة خط عرض متبوعة بنقطة خط طول. كما يجب تحديد النقاط في اتجاه عكس اتجاه عقارب الساعة.

مثلاً: [ "37.806000 -122.425592 37.775849 -122.419043 37.795547 -122.394046 37.808747" ]

geoMidpointLatitude المجموعة 2 Number

يشير إلى إحداثي خط العرض في وسط منطقة Circle.

مثلاً: 37.806000

geoMidpointLongitude المجموعة 2 Number

يشير إلى إحداثي خط الطول في وسط منطقة Circle.

مثلاً: -122.425592

geoRadius المجموعة 2 عدد صحيح

يشير إلى نصف القطر التقريبي (بالمتر) للمنطقة الدوائر.

مثلاً: 10000

postalCode المجموعة 3 String

يشير إلى الرمز البريدي.

مثلاً: 91234

addressCountry المجموعة 3 String

يشير إلى رمز البلد المكوّن من حرفَين وفقًا لمعيار ISO 3166-1 alpha-2

مثلاً: US

يعرض المثال التالي عنصر ServiceArea:

مثال

{
  "@type": "ServiceArea",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "polygon": [
    "37.4818562 -122.25801303 37.48247836 -122.25801303 37.48434484 -122.25621319 37.48621133 -122.25424681 37.49181077 -122.24704744 37.49305509 -122.24541414 37.49429942 -122.2436143 37.49803238 -122.23821477 37.49803238 -122.21285044 37.49367726 -122.15885517 37.49056645 -122.15722187 37.48621133 -122.15542202 37.48558917 -122.15525548 37.4818562 -122.15525548 37.43191387 -122.17865343 37.43191387 -122.23444854"
  ]
}

ساعات العمل (مطلوبة)

تصف نافذة الطلب التي يمكن للمستخدمين من خلالها الوصول إلى التدفق وتقديم الطلبات في أسرع وقت ممكن أو الطلبات المستقبلية. يجب تنفيذ سياسة OperationHours، ويتم ضبط الإعدادات التلقائية على تمثيل العملية في جميع الساعات في جميع الأيام.

تحدد السمتان OperationHours opens وcloses أوقات الفتح والإغلاق للنظام على الإنترنت الذي يسمح للمستخدمين بتقديم الطلبات. خلال ساعات النظام على الإنترنت هذه، استخدِم ServiceHours لتحديد ساعات العمل والإغلاق التي يمكن فيها توصيل طلبات المستخدمين.

يجب تحديد الأوقات بالتوقيت المحلي للخدمة. لا تضمِّن منطقة زمنية في قيمة opens في حال تحديد منطقة زمنية، سيتجاهل Google هذه المعلومات. لمزيد من المعلومات، يُرجى الاطّلاع على تنسيقات التاريخ والوقت.

يعرض الجدول التالي سمات النوع OperationHours:

الموقع النوع الوصف
@type الثابت

يجب ملء الحقل.

القيمة: OperationHours

@id String

يجب ملء الحقل.

معرّف فريد للكيان الذي يصف نافذة الطلب التي يمكن للمستخدمين الوصول إلى التدفق وتقديم الطلبات في أقرب وقت ممكن/في المستقبل.

مثلاً: operation_hour_1

serviceId List<String>

يجب ملء الحقل.

القيمة @id لعنصر الخدمة المرتبط بكيان Campaign Hours هذا.

مثلاً: [ "service_1" ]

opens توقيت ISO (المحلي)

تشير هذه السمة إلى الوقت المحدّد من اليوم بتنسيق ISO الذي بدءًا من الذي يمكن تقديم طلبات المستخدمين منه.

مثلاً: T00:00

closes توقيت ISO (المحلي)

تشير هذه السمة إلى الوقت المحدّد من اليوم بتنسيق ISO الذي لا يمكن تقديم طلبات المستخدمين بعده.

مثلاً: T16:00

dayOfWeek القائمة<DayOfWeek>

تمثّل هذه السمة قائمة بأيام الأسبوع التي تكون ساعات العمل هذه صالحة لها. القيم المقبولة هي "الاثنين" و"الثلاثاء" و"الأربعاء" و"الخميس" و"الجمعة" و"السبت" و "الأحد".

مثلاً: [ "MONDAY", "TUESDAY" ]

validFrom الطابع الزمني وفقًا لمعيار ISO

مطلوبة عند isSpecialHour = true.

طابع زمني بتنسيق ISO يشير إلى وقت بداية نافذة الطلب التي يمكن للمستخدمين الوصول إلى التدفق وتقديم الطلبات في أقرب وقت ممكن أو في المستقبل

مثلاً: 2017-01-01T00:00:00-07:00

validThrough الطابع الزمني وفقًا لمعيار ISO

مطلوبة عند isSpecialHour = true.

طابع زمني بتنسيق ISO يشير إلى وقت انتهاء نافذة الطلب التي لا يمكن للمستخدمين الوصول إليها بعد ذلك وتقديم طلبات في أقرب وقت ممكن/مستقبل

مثلاً: 2017-01-02T00:00:00-07:00

isSpecialHour منطقية

قيمة منطقية تشير إلى ما إذا كانت ساعات التشغيل لساعات العمل الخاصة. القيم المقبولة هي "false" و "true".

مثلاً: False

dateModified الطابع الزمني وفقًا لمعيار ISO

يشير إلى تاريخ ووقت آخر تعديل لخلاصة العنصر حقل ساعات العمل بتنسيق الطابع الزمني ISO، ولكن بالنوع سلسلة.

مثلاً: 2017-01-02T00:00:00-07:00

يعرض المثال التالي عنصر OperationHours:

مثال 1

{
  "@type": "OperationHours",
  "@id": "10824/deliveryOh",
  "serviceId": [
    "10824/delivery"
  ],
  "isSpecialHour": false
}

مثال 2

{
  "@type": "OperationHours",
  "@id": "10824/takeoutOh",
  "serviceId": [
    "10824/takeout"
  ],
  "isSpecialHour": false
}

ساعات الخدمة (مطلوبة)

يصِف هذا القسم فترة التنفيذ التي يمكن للمستخدمين من خلالها اختيار خانات التنفيذ (في أقرب وقت ممكن أو الخانات المستقبلية). يجب تنفيذ سياسة ServiceHours.

تحدد السمتان OperationHours opens وcloses أوقات الفتح والإغلاق للنظام على الإنترنت الذي يسمح للمستخدمين بتقديم الطلبات. خلال ساعات النظام على الإنترنت هذه، استخدِم ServiceHours لتحديد ساعات العمل والإغلاق التي يمكن فيها توصيل طلبات المستخدمين.

يجب تحديد الأوقات بالتوقيت المحلي للخدمة. لا تضمِّن منطقة زمنية في قيمة opens في حال تحديد منطقة زمنية، سيتجاهل Google هذه المعلومات. لمزيد من المعلومات، يُرجى الاطّلاع على تنسيقات التاريخ والوقت.

يعرض الجدول التالي سمات النوع ServiceHours:

الموقع النوع الوصف
@type الثابت

يجب ملء الحقل.

القيمة: ServiceHours

@id String

يجب ملء الحقل.

معرّف فريد للكيان الذي يصف نافذة التنفيذ التي يمكن للمستخدمين اختيار خانات التنفيذ في أقرب وقت ممكن أو الخانات المستقبلية.

مثلاً: service_hour_1

orderType OrderType

يجب ملء الحقل.

سلسلة تشير إلى ما إذا كانت ساعات الخدمة تنطبق على الطلبات في أقرب وقت ممكن أو على الطلبات المتقدّمة القيم المقبولة هي "ASAP" و "ADVANCE".

مثلاً: ASAP

serviceId List<String>

يجب ملء الحقل.

القيمة @id لعنصر الخدمة المرتبط بكيان ServiceHours هذا.

مثلاً: [ "service_1" ]

operationHoursId List<String>

مطلوبة عند isSpecialHour = false.

القيمة @id لكيان عمليات التشغيل المرتبطة بالكيان ServiceHours هذا.

مثلاً: [ "operation_hour_1" ]

opens توقيت ISO (المحلي)

تشير هذه السمة إلى الوقت المحدّد من اليوم بتنسيق ISO الذي بدءًا من الذي يمكن توصيل طلبات المستخدمين منه.

مثلاً: T00:00

closes توقيت ISO (المحلي)

تشير هذه السمة إلى الوقت المحدّد من اليوم بتنسيق ISO الذي يتعذّر بعده تنفيذ طلبات المستخدمين.

مثلاً: T16:00

dayOfWeek القائمة<DayOfWeek>

تمثّل هذه السمة قائمة بأيام الأسبوع التي تكون ساعات العمل هذه صالحة لها.

مثلاً: [ "MONDAY", "TUESDAY" ]

validFrom الطابع الزمني وفقًا لمعيار ISO

مطلوبة عند isSpecialHour = true.

طابع زمني بتنسيق ISO يشير إلى وقت بداية نافذة الطلب التي يمكن للمستخدمين الوصول إلى التدفق وتقديم الطلبات في أقرب وقت ممكن أو في المستقبل

مثلاً: 2017-01-01T00:00:00-07:00

validThrough الطابع الزمني وفقًا لمعيار ISO

مطلوبة عند isSpecialHour = true.

طابع زمني بتنسيق ISO يشير إلى وقت انتهاء نافذة الطلب التي لا يمكن للمستخدمين الوصول إليها بعد ذلك وتقديم طلبات في أقرب وقت ممكن/مستقبل

مثلاً: 2017-01-02T00:00:00-07:00

isSpecialHour منطقية

قيمة منطقية تشير إلى ما إذا كانت ساعات التشغيل لساعات العمل الخاصة. القيم المقبولة هي "false" و "true".

مثلاً: False

leadTimeMin عدد صحيح

الحدّ الأدنى لوقت التسليم/الاستلام المقدَّر بالدقائق بعد تقديم الطلب في أقرب وقت ممكن ننصحك بشدة بضبط هذه السمة.

مثلاً: 60

leadTimeMax عدد صحيح

الحد الأقصى للوقت المقدّر للتسليم/الاستلام بالدقائق بعد تقديم الطلب في أقرب وقت ممكن ننصحك بشدة بضبط هذه السمة.

مثلاً: 70

advanceBookingRequirementMin عدد صحيح

مطلوبة عند orderType = "ADVANCE".

تمثّل هذه السمة الحد الأدنى لعدد الدقائق التي تبدأ من وقت الطلب الذي يمكن خلالها توصيل الطلب المُسبَق. على سبيل المثال، إذا كان الطلب المُسبق يحتاج إلى 60 دقيقة على الأقل لتنفيذه، تكون قيمة beforeBookingRequirementMin هي 60 دقيقة.

مثلاً: 15

advanceBookingRequirementMax عدد صحيح

مطلوبة عند orderType = "ADVANCE".

تمثّل هذه السمة الحد الأقصى لعدد الدقائق التي تبدأ من وقت الطلب الذي يمكن خلالها تنفيذ الطلب المُسبَق. على سبيل المثال، إذا تم حظر توصيل طلب مسبق بعد أكثر من يومَين، تكون قيمة beforeBookingRequirementMax هي 2880.

مثلاً: 10080

advanceBookingSlotInterval String

مطلوبة عند orderType = "ADVANCE".

الفاصل بين خانتين متتاليتين للحجز المسبق. على سبيل المثال: إذا كان يفتح أبوابه ويغلقها في الساعة 8 صباحًا و8 مساءً، في حين أنّ المدة التي تتراوح فيها بين 15 دقيقة وبداية من 15 دقيقة، يمكن للمستخدم اختيار أوقات توصيل الطلبات، وهي 8:15 صباحًا و8:15 صباحًا و8:30 صباحًا و8:45 صباحًا، وهكذا حتى الساعة 8 مساءً. يجب تحديد المدة كمدة دورة ISO. على سبيل المثال: يعني "PT15M" فواصل زمنية تبلغ 15 دقيقة.

مثلاً: PT15M

dateModified الطابع الزمني وفقًا لمعيار ISO

تاريخ ووقت آخر تعديل لخلاصة الكيان ServiceHours بتنسيق الطابع الزمني ISO ولكن بالنوع سلسلة.

مثلاً: 2017-01-02T00:00:00-07:00

يعرض المثال التالي عنصر ServiceHours:

مثال 1

{
  "@type": "ServiceHours",
  "@id": "613741/delivery",
  "orderType": "ASAP",
  "serviceId": [
    "10824/delivery"
  ],
  "opens": "T00:00",
  "closes": "T00:00",
  "isSpecialHour": true,
  "validFrom": "2017-12-25T00:00:00-07:00",
  "validThrough": "2017-12-25T23:59:00-07:00"
}

مثال 2

{
  "@type": "ServiceHours",
  "@id": "10824/takeoutSh_0",
  "orderType": "ASAP",
  "serviceId": [
    "10824/takeout"
  ],
  "operationHoursId": [
    "10824/takeoutOh"
  ],
  "opens": "11:00",
  "closes": "21:00",
  "dayOfWeek": [
    "MONDAY",
    "TUESDAY",
    "WEDNESDAY",
    "THURSDAY"
  ],
  "isSpecialHour": false
}

رسوم

تصف هذه الرسوم الرسوم. في حال ضبط الكيان Service المرتبط على serviceType على "DELIVERY"، يجب ضبط Fee مع ضبط feeType على "DELIVERY".

يعرض الجدول التالي سمات النوع Fee:

الموقع النوع الوصف
@type الثابت

يجب ملء الحقل.

القيمة: Fee

@id String

يجب ملء الحقل.

معرّف فريد للكيان الذي يصف الرسوم.

مثلاً: service_fee_1

serviceId List<String>

يجب ملء الحقل.

القيمة @id لعنصر الخدمة المرتبط بكيان "الرسوم" هذا.

مثلاً: [ "service_1" ]

feeType FeeType

يجب ملء الحقل.

سلسلة تشير إلى ما إذا كانت الرسوم تنطبق على طلبات التسليم أو الخدمة القيمتان المقبولتان هما "DELIVERY" و "SERVICE".

مثلاً: DELIVERY

priceCurrency String

يجب ملء الحقل.

تمثّل هذه السمة رمز العملة بالتنسيق ISO 4217 المكوَّن من 3 أحرف.

مثلاً: USD

basePrice Number

السعر الأساسي للرسوم، والذي يسري عند استخدام percentageOfCart أو pricePerMeter.

مثلاً: 2.0

minPrice Number

الحد الأدنى للرسوم، يحدد قيمة الرسوم عند استخدام percentageOfCart أو pricePerMeter.

مثلاً: 2.0

maxPrice Number

الحد الأقصى للرسوم، يضع قيمة الرسوم عند استخدام percentageOfCart أو pricePerMeter.

مثلاً: 10.0

eligibleRegion List<String>

تمثّل هذه السمة @id of the ServiceArea للمنطقة الجغرافية والسياسية التي تسري فيها الرسوم. لا تستخدِم هذه السمة إلا إذا كانت رسوم التوصيل تختلف حسب المنطقة.

مثلاً: [ "service_area_1" ]

eligibleTransactionVolumeMin Number

الحد الأدنى لحجم المعاملات في وحدة نقدية والتي تكون مواصفات هذه الرسوم صالحة لها.

مثلاً: 50

eligibleTransactionVolumeMax Number

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

مثلاً: 10

validFrom الطابع الزمني وفقًا لمعيار ISO

طابع زمني وفقًا لمعيار ISO يشير إلى وقت بدء سريان الرسوم.

مثلاً: 2017-01-01T00:00:00-07:00

validThrough الطابع الزمني وفقًا لمعيار ISO

طابع زمني وفقًا لمعيار ISO يشير إلى وقت الانتهاء الذي تكون الرسوم بعده غير صالحة.

مثلاً: 2017-01-02T00:00:00-07:00

dateModified الطابع الزمني وفقًا لمعيار ISO

تاريخ ووقت آخر تعديل لخلاصة عنصر الرسوم بتنسيق الطابع الزمني ISO ولكن بنوع سلسلة.

مثلاً: 2017-01-02T00:00:00-07:00

priority Number

قيمة موجبة وليست صفرية. عندما يتم تطبيق أكثر من رسم واحد على سلة تسوّق المستخدم، ستكون الأولوية للرسوم ذات الأولوية القصوى. وفي حال توفير هذا الحقل، تحظى الأولوية دائمًا بالأولوية على الأولوية المحسوبة.

مثلاً: 3

يجب استخدام مجموعة واحدة فقط من مجموعات المواقع الإلكترونية التالية.
price المجموعة 1 Number

سعر الرسوم. إذا لم يكن السعر ثابتًا، يمكن تقديم minPrice وmaxPrice بدلاً من السعر.

مثلاً: 1.5

percentageOfCart المجموعة 2 Number

الرسوم بالنسبة المئوية لقيمة سلة التسوّق. والقيم المقبولة هي قيم عائمة تتراوح بين 0 و100 بشكل شامل.

مثلاً: 9.00

pricePerMeter المجموعة 3 Number

الرسوم لكل متر للمسافة الشعاعية من المستخدم. مثلاً، إذا كانت المسافة إلى المستخدم 5 كيلومتر وبلغ السعر 0.001 دولار أمريكي، ستكون رسوم المستخدم 5 دولار أمريكي.

مثلاً: 0.001

يعرض المثال التالي عنصر Fee:

مثال 1

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "price": 5
}

مثال 2

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "pricePerMeter": 0.0005,
  "basePrice": 4
}

مثال 3

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "pricePerMeter": 0.0005,
  "basePrice": 4,
  "minPrice": 5,
  "maxPrice": 50
}

مثال 4

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "percentageOfCart": 5,
  "basePrice": 4
}

المثال الخامس

{
  "@type": "Fee",
  "@id": "28427",
  "serviceId": [
    "10824/delivery"
  ],
  "feeType": "DELIVERY",
  "priceCurrency": "USD",
  "eligibleRegion": [
    "28427"
  ],
  "eligibleTransactionVolumeMin": 20,
  "percentageOfCart": 5,
  "basePrice": 4,
  "minPrice": 5,
  "maxPrice": 50
}

تمثّل هذه السمة كيانًا مطلوبًا للتنفيذ. وصف قائمة الطعام.

يعرض الجدول التالي سمات النوع Menu:

الموقع النوع الوصف
@type الثابت

يجب ملء الحقل.

القيمة: Menu

@id String

يجب ملء الحقل.

معرّف فريد للقائمة.

مثلاً: menu_1

name String

النص الذي يمكنه تحديد القائمة عندما يتصفح المستخدم القائمة.

مثلاً: Foo

disclaimer String

إخلاء المسؤولية عن القائمة على سبيل المثال، الإفصاح عن المعلومات الغذائية والإفصاح عن مسببات الحساسية.

مثلاً: Items may contain peanuts.

disclaimerUrl عنوان URL

عنوان URL يشير إلى صفحة تقدّم المزيد من التفاصيل حول بيان إخلاء المسؤولية

dateModified الطابع الزمني وفقًا لمعيار ISO

تاريخ ووقت آخر تعديل لخلاصة عنصر القائمة بتنسيق الطابع الزمني ISO ولكن باستخدام النوع "سلسلة".

مثلاً: 2017-01-02T00:00:00-07:00

يعرض المثال التالي عنصر Menu:

{
  "@type": "Menu",
  "@id": "10824"
}

كيان اختياري لتنفيذه. تصف قسمًا معينًا في القائمة.

يعرض الجدول التالي سمات النوع MenuSection:

الموقع النوع الوصف
@type الثابت

يجب ملء الحقل.

القيمة: MenuSection

@id String

يجب ملء الحقل.

معرّف فريد لقسم القائمة

مثلاً: menu_section_1

menuId القائمة<ReverseReference>

تشير هذه السمة إلى قيمة @id للكيان القائمة المرتبط بكيان MenuSection هذا.

مثلاً: [ { "@id": "menu_id", "displayOrder": 4 } ]

menuSectionId List<String>

قائمة بقيم @id للكيانات MenuSection الفرعية التي تتوافق مع كيان MenuSection هذا.

ملاحظة مهمة: يجب استخدام مرجع واحد فقط من menuSectionId أو parentMenuSectionId(in child).

مثلاً: [ "child_menu_section_1", "child_menu_section_2" ]

parentMenuSectionId القائمة<ReverseReference>

تشير هذه السمة إلى القيمة @id للكيان MenuSection الرئيسي المرتبط بهذا الكيان MenuSection.

ملاحظة مهمة: يجب استخدام مرجع واحد فقط من parentMenuSectionId أو menuSectionId(in parent).

مثلاً: [ { "@id": "parent_menu_section_id", "displayOrder": 4 } ]

name String

يجب ملء الحقل.

النص الذي يمكنه التعرّف على السمة MenuSection عندما يتصفّح المستخدِم القائمة.

مثلاً: Foo

description String

تمثّل هذه السمة وصفًا لقسم قائمة الطعام.

مثلاً: Example menu section description that helps users.

image عنوان URL

تمثّل هذه السمة عنوان URL لصورة قسم القائمة.

مثلاً: https://provider.com/someimage

menuItemId List<String>

تمثّل هذه السمة قائمة بقيم @id للكيانات MenuItem التي تتوافق مع كيان MenuSection هذا.

ملاحظة مهمة: يجب استخدام مرجع واحد فقط من menuItemId أو MenuItem.parentMenuSectionId.

مثلاً: [ "menu_item1", "menu_item2" ]

parentMenuItemId القائمة<ReverseReference>

قائمة بقيم @id للكيانات MenuItem الرئيسية التي تتوافق مع كيان MenuSection هذا.

ملاحظة مهمة: يجب استخدام مرجع واحد فقط من parentMenuItemId أو MenuItem.menuAddOnId.

مثلاً: [ { "@id": "parent_menu_item_id", "displayOrder": 4 } ]

parentMenuItemOptionId القائمة<ReverseReference>

قائمة بقيم @id للكيانات MenuItemOption الرئيسية التي تتوافق مع كيان MenuSection هذا.

ملاحظة مهمة: يجب استخدام مرجع واحد فقط من parentMenuItemOptionId أو MenuItemOption.menuAddOnId.

مثلاً: [ { "@id": "parent_menu_item_option_id", "displayOrder": 4 } ]

eligibleQuantityMax عدد صحيح

الحد الأقصى لعدد الإضافات التي يمكن اختيارها في قسم الإضافة

مثلاً: 5

eligibleQuantityMin عدد صحيح

الحد الأدنى لعدد الإضافات التي يجب اختيارها في قسم الإضافة.

مثلاً: 1

defaultItemId List<String>

قائمة بـ @id تشير إلى كيانات MenuItem ليتم اختيارها مسبقًا للمستخدمين في الإضافة MenuSection. يمكن للمستخدمين تغيير الاختيارات النهائية. في حال عدم تحديد defaultItemId، لن يتم اختيار MenuItem مسبقًا.

مثلاً: [ "item1", "item2" ]

availabilityId List<String>

تمثّل هذه السمة قيم @id لعناصر مدى التوفّر التي تقدّم تفاصيل حول وقت توفّر قسم القائمة.

مثلاً: [ "menu_availability_1" ]

numberOfFreeAddOns عدد صحيح

يشير إلى عدد الإضافات التي يمكن للمستخدم اختيارها بدون أي رسوم. صالح فقط لأقسام قائمة الإضافات.

مثلاً: 3

dateModified الطابع الزمني وفقًا لمعيار ISO

تاريخ ووقت آخر تعديل لخلاصة الكيان MenuSection بتنسيق الطابع الزمني ISO ولكن بنوع سلسلة.

مثلاً: 2017-01-02T00:00:00-07:00

applicableServiceType القائمة<ServiceType>

الخدمة التي تسري عليها MenuSection هذه. تفترض الإعدادات التلقائية أنّ السمة MenuSection تنطبق على الكل.

offeredById List<String>

قيم @id للكيانات Restaurant التي تتوفّر فيها MenuSection. تفترض الإعدادات التلقائية أنّ "MenuSection" متوفّر في جميع المواقع الجغرافية.

مثلاً: [ "restaurant_id_1", "restaurant_id_55" ]

يعرض المثال التالي عنصر MenuSection:

{
  "@type": "MenuSection",
  "@id": "853705",
  "menuId": [
    {
      "@id": "10824",
      "displayOrder": 853705
    }
  ],
  "menuSectionId": [
    12345,
    43645
  ],
  "name": "Pasta",
  "applicableServiceType": [
    "TAKEOUT"
  ],
  "offeredById": [
    "italian_restaurant_location_1"
  ]
}
{
  "@type": "MenuSection",
  "@id": "427484",
  "menuId": [
    {
      "@id": "4287",
      "displayOrder": 964376
    }
  ],
  "menuItemId": [
    46784,
    42728
  ],
  "name": "Burger",
  "applicableServiceType": [
    "TAKEOUT",
    "DELIVERY"
  ]
}
{
  "@type": "MenuSection",
  "@id": "3138486",
  "name": "Choose a side:",
  "parentMenuItemId": [
    {
      "@id": "6680295",
      "displayOrder": 3138486
    }
  ],
  "eligibleQuantityMax": "5",
  "numberOfFreeAddOns": "2"
}
{
  "@type": "MenuSection",
  "@id": "3138482",
  "name": "Additional Pizza Toppings",
  "parentMenuItemId": [
    {
      "@id": "6680246",
      "displayOrder": 3138482
    }
  ],
  "eligibleQuantityMax": "3"
}

مدى توفّر الخدمة

كيان اختياري لتنفيذه. تصف الفترة الزمنية التي يتم خلالها عرض كيان MenuSection.

يعرض الجدول التالي سمات النوع Availability:

الموقع النوع الوصف
@type الثابت

يجب ملء الحقل.

القيمة: Availability

@id String

يجب ملء الحقل.

تمثّل هذه السمة معرّفًا فريدًا للكيان الذي يصف مدى توفّر قسم القائمة.

مثلاً: menu_section_avail_1

availabilityStarts توقيت ISO (المحلي)

طابع ISO الزمني الذي يشير إلى وقت البدء الذي يكون فيه قسم القائمة صالحًا.

مثلاً: T00:00

availabilityEnds توقيت ISO (المحلي)

الطابع الزمني وفقًا لمعيار ISO الذي يشير إلى وقت الانتهاء الذي لا يكون مدى توفّر قسم القائمة بعده غير صالح.

مثلاً: T16:00

availableDay القائمة<DayOfWeek>

تمثّل هذه السمة قائمة بأيام الأسبوع التي يكون فيها توفُّر قسم القائمة صالحًا.

مثلاً: [ "MONDAY", "TUESDAY" ]

validFrom الطابع الزمني وفقًا لمعيار ISO

طابع زمني وفقًا لمعيار ISO يشير إلى وقت البدء الذي يكون فيه قسم القائمة صالحًا.

مثلاً: 2017-01-01T00:00:00-07:00

validThrough الطابع الزمني وفقًا لمعيار ISO

طابع زمني وفقًا لمعيار ISO يشير إلى وقت الانتهاء الذي لا يكون مدى توفّر قسم القائمة بعده غير صالح

مثلاً: 2017-01-02T00:00:00-07:00

dateModified الطابع الزمني وفقًا لمعيار ISO

تاريخ ووقت آخر تعديل لخلاصة عنصر مدى التوفّر بتنسيق الطابع الزمني ISO ولكن بنوع سلسلة.

مثلاً: 2017-01-02T00:00:00-07:00

يعرض المثال التالي عنصر Availability:

مثال

{
  "@type": "Availability",
  "@id": "85343705",
  "availabilityStarts": "06:00",
  "availabilityEnds": "22:30",
  "availableDay": [
    "SATURDAY",
    "SUNDAY"
  ]
}

تمثّل هذه السمة كيانًا مطلوبًا للتنفيذ. يصف عنصرًا في كيان Menu.

يعرض الجدول التالي سمات النوع MenuItem:

الموقع النوع الوصف
@type الثابت

يجب ملء الحقل.

القيمة: MenuItem

@id String

يجب ملء الحقل.

معرّف فريد لعنصر في القائمة

مثلاً: menu_item_1

name String

يجب ملء الحقل.

النص الذي يمكنه التعرّف على السمة MenuItem عندما يتصفّح المستخدِم القائمة.

مثلاً: Foo

description String

وصف صنف في القائمة

مثلاً: Foo

image عنوان URL

تمثّل هذه السمة عنوان URL لصورة صنف في القائمة.

مثلاً: http://someprovider.com/someimage

parentMenuSectionId القائمة<ReverseReference>

قائمة بقيم @id للكيانات MenuSection الرئيسية التي تتوافق مع كيان MenuItem هذا.

ملاحظة مهمة: يجب استخدام مرجع واحد فقط من parentMenuSectionId أو MenuSection.menuItemId.

مثلاً: { "@id": "menu_section_parent_id", "displayOrder": 4 }

menuAddOnId List<String>

تمثّل هذه السمة قائمة بقيم @id للكيانات MenuSection الواردة في القسم add on الذي يتوافق مع الكيان MenuItem هذا.

ملاحظة مهمة: يجب استخدام مرجع واحد فقط من menuAddOnId أو MenuSection.parentMenuItemId.

مثلاً: menu_addon_1

nutrition NutritionInformation

المعلومات الغذائية للطبق، لا سيما السعرات الحرارية.

مثلاً: { "calories": "120-150 Cal" }

allergen القائمة<Allergen>

مسببات الحساسية في عنصر القائمة هذا.

مثلاً: [ { "allergenType": "PEANUTS", "levelOfContainment": "MAY_CONTAIN" } ]

additive القائمة<Additive>

إضافات عنصر القائمة هذا.

مثلاً: [ { "additiveName": "Sodium nitrite", "levelOfContainment": "CONTAINS" } ]

suitableDiet القائمة<RestrictedDiet>

يتوافق الطبق مع الخصائص الغذائية المذكورة.

مثلاً: [ "DIABETIC", "GLUTEN_FREE" ]

depositInfo DepositInfo

معلومات التغليف وإعادة التدوير لهذا العنصر في القائمة

مثلاً: { "depositCode": "RECYCLABLE", "depositValue": "0.05", "depositValueCurrency": "USD" }

numberOfServings عدد صحيح

عدد الأطباق المتاحة في عنصر معيّن في القائمة

مثلاً: 2

dateModified الطابع الزمني وفقًا لمعيار ISO

تاريخ ووقت آخر تعديل لخلاصة الكيان MenuItem بتنسيق الطابع الزمني ISO ولكن بنوع سلسلة.

مثلاً: 2017-01-02T00:00:00-07:00

يعرض المثال التالي عنصر MenuItem:

{
  "@type": "MenuItem",
  "@id": "18931508",
  "name": "Sauteed Baby Spinach",
  "parentMenuSectionId": [
    {
      "@id": "3138479",
      "displayOrder": 18931508
    }
  ]
}
{
  "@type": "MenuItem",
  "@id": "18931508",
  "name": "Hamburger",
  "parentMenuSectionId": [
    {
      "@id": "4645747",
      "displayOrder": 12345
    }
  ],
  "nutrition": {
    "calories": "400 cal"
  },
  "allergen": [
    {
      "allergenType": "GLUTEN",
      "levelOfContainment": "CONTAINS"
    }
  ],
  "additive": [
    {
      "additiveName": "Sodium nitrite",
      "levelOfContainment": "CONTAINS"
    }
  ],
  "suitableDiet": [
    "DIABETIC",
    "LOW_FAT"
  ]
}

كيان اختياري لتنفيذه. تصف الخيارات التي سيحتاج المستخدم إلى إجرائها عند اختيار طبق/المختلط. يجب أن يحدّد المستخدم خيارًا، وإلا يُعتبَر الطلب غير صالح (على سبيل المثال، يجب على المستخدم اختيار بيتزا صغيرة أو متوسطة أو كبيرة).

يعرض الجدول التالي سمات النوع MenuItemOption:

الموقع النوع الوصف
@type الثابت

القيمة: MenuItemOption

@id String

يجب ملء الحقل.

معرّف فريد لخيار عنصر القائمة

مثلاً: menu_item_1_option

menuItemId ReverseReference

يجب ملء الحقل.

تشير هذه السمة إلى القيمة @id للكيان MenuItem المرتبط بهذا الكيان MenuItemOption.

مثلاً: { "@id": "menu_item_1", "displayOrder": 4 }

optionType OptionType

سلسلة تشير إلى ما إذا كان خيار عنصر القائمة مصنّفًا حسب الحجم أو الخيار أو جانب البيتزا. القيم المقبولة هي "size" و"OPTION" و "PIZZA_SIDE". "الحجم": حجم MenuItemOption. على سبيل المثال، صغير أو متوسط أو كبير. "الخيار": أي خيار غير المقاس (على سبيل المثال، طبق يقدّم إما سلطة أو شطيرة). إذا لم تتمكن من التمييز بين "size" و"OPTION"، استخدم "OPTION". "PIZZA_SIDE": خاص بالبيتزا: على سبيل المثال، إنّ السمة MenuItemOption صالحة فقط لجزء من البيتزا كاملةً (مثل إضافات الفطر على الجانب الأيسر أو الأيمن أو البيتزا الكاملة).

مثلاً: SIZE

value سلسلة أو PizzaSide

مطلوبة عند optionType is defined.

قيمة سلسلة أو قيمة تعداد قيم التعداد خاصة بنوع الخيار PIZZA_SIDE.

applicableParentOptionValue String

سلسلة تحتوي على قيمة خيار العنصر الرئيسي الذي يتوفّر لها هذا الخيار.

مثلاً: Small

menuAddOnId List<String>

تمثّل هذه السمة قائمة بقيم @id للكيانات MenuSection الواردة في القسم add on الذي يتوافق مع الكيان MenuItemOption هذا.

ملاحظة مهمة: يجب استخدام مرجع واحد فقط من menuAddOnId أو MenuSection.parentMenuItemId.

مثلاً: menuAddOnId

nutrition NutritionInformation

المعلومات الغذائية للطبق، لا سيما السعرات الحرارية.

مثلاً: { "calories": "120-150 Cal" }

allergen القائمة<Allergen>

مسببات الحساسية في عنصر القائمة هذا.

مثلاً: { "allergenType": "PEANUTS", "levelOfContainment": "MAY_CONTAIN" }

additive القائمة<Additive>

إضافات عنصر القائمة هذا.

مثلاً: { "additiveName": "Sodium nitrite", "levelOfContainment": "CONTAINS" }

depositInfo DepositInfo

معلومات التغليف وإعادة التدوير الخاصة بعنصر MenuItem هذا

مثلاً: { "depositCode": "RECYCLABLE", "depositValue": "0.05", "depositValueCurrency": "USD" }

numberOfServings عدد صحيح

عدد الأطباق المتاحة في خيار معيّن لعنصر في القائمة.

مثلاً: 2

dateModified الطابع الزمني وفقًا لمعيار ISO

تاريخ ووقت آخر تعديل لخلاصة العنصر MenuItemOption بتنسيق الطابع الزمني ISO ولكن باستخدام النوع "سلسلة"

مثلاً: 2017-01-02T00:00:00-07:00

يعرض المثال التالي عنصر MenuItemOption:

{
  "@type": "MenuItemOption",
  "@id": "56177944",
  "menuItemId": {
    "@id": "18930213",
    "displayOrder": 1234
  },
  "optionType": "PIZZA_SIDE",
  "value": "PIZZA_SIDE_LEFT"
}
{
  "@type": "MenuItemOption",
  "@id": "56177944",
  "menuItemId": {
    "@id": "18930213",
    "displayOrder": 1234
  },
  "applicableParentOptionValue": "Small Pizza"
}

تمثّل هذه السمة كيانًا مطلوبًا للتنفيذ. تصف عرضًا لكيان MenuItem أو MenuItemOption.

يعرض الجدول التالي سمات النوع MenuItemOffer:

الموقع النوع الوصف
@type الثابت

يجب ملء الحقل.

القيمة: MenuItemOffer

@id String

يجب ملء الحقل.

معرّف فريد لعرض عنصر في القائمة

مثلاً: menu_item_offer

sku String

يجب ملء الحقل.

معرّف العرض الترويجي لعنصر القائمة يمكن أن تكون قيم رمز التخزين التعريفي مختلفة أو متطابقة في العديد من كيانات عروض عناصر القائمة. سيتم ضبط قيمة رمز التخزين التعريفي بالترتيب عندما نجري اتصالاً بواجهة برمجة التطبيقات لك.

مثلاً: Menu_item_offer_sku

price Number

يجب ملء الحقل.

سعر عرض عنصر القائمة.

مثلاً: 2.5

priceCurrency String

يجب ملء الحقل.

تمثّل هذه السمة رمز العملة بالتنسيق ISO 4217 المكوَّن من 3 أحرف.

مثلاً: USD

availabilityId List<String>

قيم @id للكيانات المتعلّقة بمدى التوفّر والتي تقدّم تفاصيل حول وقت توفّر عرض عنصر القائمة.

مثلاً: [ "menu_availability_1" ]

eligibleQuantityMin Number

الحدّ الأدنى للكمية في الطلب التي تكون السمة MenuItemOffer صالحة لها

مثلاً: 1

eligibleQuantityMax Number

الحدّ الأقصى للكمية في الطلب التي تكون السمة MenuItemOffer صالحة لها

مثلاً: 25

inventoryLevel Number

مستوى المستودع التقريبي الحالي للسلعة أو السلع المقابلة لهذه السمة MenuItemOffer هذه.

مثلاً: 10

dateModified الطابع الزمني وفقًا لمعيار ISO

تاريخ ووقت آخر تعديل لخلاصة الكيان MenuItemOffer بتنسيق الطابع الزمني ISO ولكن بنوع سلسلة.

مثلاً: 2017-01-02T00:00:00-07:00

applicableServiceType القائمة<ServiceType>

الخدمة التي تسري عليها MenuItemOffer هذه. تفترض الإعدادات التلقائية أنّ السمة MenuItemOffer تنطبق على الكل.

offeredById List<String>

قيم @id للكيانات Restaurant التي تتوفّر فيها MenuItemOffer. تفترض الإعدادات التلقائية أنّ "MenuItemOffer" متوفّر في جميع المواقع الجغرافية.

مثلاً: [ "restaurant_id_5", "restaurant_id_26" ]

يجب استخدام مجموعة واحدة فقط من مجموعات المواقع الإلكترونية التالية.
menuItemId المجموعة 1 String

تشير هذه السمة إلى القيمة @id للكيان MenuItem المرتبط بهذا الكيان MenuItemOffer.

مثلاً: menu_item_1

menuItemOptionId المجموعة 2 String

تشير هذه السمة إلى القيمة @id للكيان MenuItemOption المرتبط بهذا الكيان MenuItemOffer.

مثلاً: menu_item_option_1

يعرض المثال التالي عنصر MenuItemOffer:

{
  "@type": "MenuItemOffer",
  "@id": "6680262",
  "sku": "offer-mediterranean-bagel",
  "menuItemId": "896532",
  "price": 15.5,
  "priceCurrency": "USD",
  "applicableServiceType": [
    "DELIVERY"
  ],
  "offeredById": [
    "bagel_shop_location_5"
  ]
}

الإعدادات الشائعة

ReverseReference

يعرض الجدول التالي سمات النوع ReverseReference:

الموقع النوع الوصف
@id String

يجب ملء الحقل.

@id للكيان الرئيسي.

displayOrder عدد صحيح

يجب ملء الحقل.

عرض ترتيب السلعة داخل العنصر الرئيسي.

NutritionInformation

يعرض الجدول التالي سمات النوع NutritionInformation:

الموقع النوع الوصف
description String

معلومات التغذية في نص حر. على سبيل المثال، "يحتوي على مواد حافظة".

calories String

عدد السعرات الحرارية في السعرات الحرارية أو السعرات الحرارية أو كيلو جول، باستخدام التنسيق التالي: value Cal أو min-max Cal

مثلاً: 120.34 Cal

sodiumContent String

عدد المليغرام أو الغرام من الصوديوم، باستخدام الصيغة التالية: القيمة g أو min-max g

مثلاً: 1200 mg

يعرض المثال التالي عنصر NutritionInformation:

مثال

{
  "calories": "120-150 Cal",
  "sodiumContent": "100 mg"
}

مسبب الحساسية

يعرض الجدول التالي سمات النوع Allergen:

الموقع النوع الوصف
allergenType AllergenType

يجب ملء الحقل.

نوع مسبب الحساسية

levelOfContainment ContainmentLevel

مستوى مسببات حساسية معيّنة في عنصر القائمة

يعرض المثال التالي عنصر Allergen:

مثال

{
  "allergenType": "PEANUTS",
  "levelOfContainment": "MAY_CONTAIN"
}

مضافة

يعرض الجدول التالي سمات النوع Additive:

الموقع النوع الوصف
additiveName String

يجب ملء الحقل.

اسم المضاف.

levelOfContainment ContainmentLevel

مستوى مادة مضافة معينة في عنصر القائمة.

يعرض المثال التالي عنصر Additive:

مثال

{
  "additiveName": "Sodium nitrite",
  "levelOfContainment": "CONTAINS"
}

DepositInfo

يعرض الجدول التالي سمات النوع DepositInfo:

الموقع النوع الوصف
depositCode DepositCode

رمز الإيداع.

depositValue Number

القيمة العددية لإيداع السلعة، على سبيل المثال، عند إعادة تدويرها

depositValueCurrency String

عملة قيمة الإيداع

يعرض المثال التالي عنصر DepositInfo:

مثال

{
  "depositCode": "RECYCLABLE",
  "depositValue": 0.05,
  "depositValueCurrency": "USD"
}

ServingConfig

إعدادات العرض للخدمة المستخدمة للتحكّم في ميزات مختلفة، مثل إيقاف التطبيق المصغّر للعرض الترويجي وما إلى ذلك

يعرض الجدول التالي سمات النوع ServingConfig:

الموقع النوع الوصف
disableOrderInstructions منطقية

إخفاء إمكانية تحديد تعليمات الطلب

disableMenuItemSpecialInstructions منطقية

لإخفاء القدرة على تحديد تعليمات خاصة في عنصر قائمة.

disableTipWidget منطقية

لإخفاء التطبيق المصغّر للملاحظة في صفحة "تقديم الطلب" ضمن مسار الطلب.

disablePromoWidget منطقية

إخفاء التطبيق المصغّر للعرض الترويجي في صفحة "تقديم الطلب" ضمن مسار الطلب

menuItemSpecialInstructionsMaxLength Number

تُحدِّد الحد الأقصى لعدد الأحرف التي يمكن أن تحتوي عليها التعليمات الخاصة لعنصر القائمة.

orderInstructionsMaxLength Number

تحدّد هذه السمة الحد الأقصى لعدد الأحرف التي يمكن أن تتضمّنها تعليمات الطلب.

يعرض المثال التالي عنصر ServingConfig:

مثال 1

{
  "disableMenuItemSpecialInstructions": true
}

مثال 2

{
  "disableTipWidget": true,
  "disablePromoWidget": true
}

مثال 3

{
  "menuItemSpecialInstructionsMaxLength": 250,
  "orderInstructionsMaxLength": 1000
}

عمليات التعداد

DayOfWeek

يحتوي النوع DayOfWeek على القيم المحتملة التالية:

  • MONDAY
  • TUESDAY
  • WEDNESDAY
  • THURSDAY
  • FRIDAY
  • SATURDAY
  • SUNDAY

ServiceType

يحتوي النوع ServiceType على القيم المحتملة التالية:

  • DELIVERY
  • TAKEOUT

OrderType

يحتوي النوع OrderType على القيم المحتملة التالية:

  • ASAP
  • ADVANCE

FeeType

يحتوي النوع FeeType على القيم المحتملة التالية:

  • DELIVERY
  • SERVICE

OptionType

يحتوي النوع OptionType على القيم المحتملة التالية:

  • SIZE
  • OPTION
  • PIZZA_SIDE

PizzaSide

يحتوي النوع PizzaSide على القيم المحتملة التالية:

  • PIZZA_SIDE_LEFT
  • PIZZA_SIDE_RIGHT
  • PIZZA_SIDE_WHOLE

AllergenType

نوع مسببات الحساسية حسب gs1:AllergenTypeCode.

يحتوي النوع AllergenType على القيم المحتملة التالية:

  • ALMONDS
  • ALPHA_ISOMETHYL_IONONE
  • ALCOHOL
  • AMYL_CINNAMAL
  • ANISE_ALCOHOL
  • BARLEY
  • BENZYL_ALCOHOL
  • BENZYL_BENZOATE
  • BENZYL_CINNAMATE
  • BENZYL_SALICYLATE
  • BRAZIL_NUTS
  • BUTYLPHENYL_METHYLPROPIONATE
  • CARROTS
  • CASHEW_NUTS
  • CELERY
  • CEREALS_CONTAINING_GLUTEN
  • CINNAMAL
  • CINNAMYL_ALCOHOL
  • CITRAL
  • CITRONELLOL
  • COCOA
  • CORIANDER
  • CORN
  • COUMARIN
  • CRUSTACEANS
  • EGGS
  • EUGENOL
  • EVERNIA_FURFURACEA
  • EVERNIA_PRUNASTRI
  • FARNESOL
  • FISH
  • GERANIOL
  • GLUTEN
  • HAZELNUTS
  • HEXYL_CINNAMAL
  • HYDROXYCITRONELLAL
  • HYDROXYISOHEXYL_3_CYCLOHEXENE_CARBOXALDEHYDE_ISOEUGENOL_LIMONENE_LINAL
  • KAMUT
  • LACTOSE
  • LUPINE
  • MACADAMIA_NUTS
  • METHYL_2_OCTYNOATE
  • MILK
  • MOLLUSCS
  • MUSTARD
  • NO_DECLARED_ALLERGENS
  • OAT
  • PEANUTS
  • PEAS
  • PECAN_NUTS
  • PISTACHIOS
  • POD_FRUITS
  • QUEENSLAND_NUTS
  • RYE
  • SESAME_SEEDS
  • SOYBEANS
  • SPELT
  • SULPHUR_DIOXIDE
  • TREE_NUTS
  • TREE_NUT_TRACES
  • WALNUTS
  • WHEAT

ContainmentLevel

يحتوي النوع ContainmentLevel على القيم المحتملة التالية:

  • CONTAINS
  • FREE_FROM
  • MAY_CONTAIN

DepositCode

يحتوي النوع DepositCode على القيم المحتملة التالية:

  • REUSABLE
  • RECYCLABLE

DealType

فئة الصفقة التي تريد تطبيق الخصم عليها يمكن أن تتمثل الفئة في إجمالي سلة التسوق بالكامل أو رسوم التوصيل.

يحتوي النوع DealType على القيم المحتملة التالية:

  • CART_OFF
  • DELIVERY_OFF

RestrictedDiet

نوع الأنظمة الغذائية المحظورة حسب schema.org:RestrictedDiet.

يحتوي النوع RestrictedDiet على القيم المحتملة التالية:

  • DIABETIC
  • GLUTEN_FREE
  • HALAL
  • HINDU
  • KOSHER
  • LOW_CALORIE
  • LOW_FAT
  • LOW_LACTOSE
  • LOW_SALT
  • VEGAN
  • VEGETARIAN