نظرة عامة

يمكن لشركاء Google تقديم بيانات قائمة الطعام المنظَّمة إلى Google من خلال عملية التكامل الشاملة مع Reservations End-to-End لاستخدامها في قسم قائمة الطعام ضمن الملف التجاري على Google للمطعم ونقاط دخول أخرى على مساحات عرض Google المخصّصة للمستهلكين.

يتم استيعاب بيانات القائمة باستخدام الخلاصات العامة. قبل البدء:

  1. تأكَّد من إكمال إعداد الحساب.
  2. فهم عملية تحميل "الخلاصة العامة"
  3. التعرّف على كيفية ضبط حسابك لتحميل الخلاصات العامة

إنشاء خلاصات قوائم الطعام وتحميلها

عند إنشاء "خلاصات قوائم الطعام" وتحميلها، اتّبِع الإرشادات والاصطلاحات التالية:
  • لتقديم تفاصيل المطعم، اتّبِع مواصفات البيانات الموضّحة في خلاصة التاجر. للاطّلاع على مثال لملف JSON، يُرجى الرجوع إلى نموذج JSON. يجب أن تكون أسماء ملفات البيانات فريدة بين عمليات التحميل. ننصحك بتضمين طابع زمني في اسم الملف، مثل menu1_1633621547.json.
  • في واصف مجموعة الملفات لخلاصة القائمة، اضبط الحقل name على google.food_menu. للاطّلاع على مثال على محتوى ملف الواصف، يمكنك الرجوع إلى نموذج JSON لملف الواصف. يجب أن تكون أسماء ملفات الواصف فريدة بين عمليات التحميل. ننصحك بتضمين طابع زمني في اسم الملف، مثلاً descriptor_1633621547.filesetdesc.json. يجب تحميل ملف الواصف إلى خادم SFTP العام كجزء من خلاصة قائمة الطعام.
  • يجب تحميل الخلاصات إلى خادم بروتوكول النقل الآمن للملفات (SFTP) العام بوتيرة يومية كتحديثات كاملة.
  • يجب ألا تتجاوز الخلاصات 1,000 جزء (ملف) كما هو موضّح في استخدام بروتوكول نقل الملفات الآمن (SFTP) للخلاصة العامة.

يمكن الاطّلاع على حالة استيعاب الخلاصة في قسم الاستيعاب > السجلّ في بوابة الشريك. يمكن العثور على معلومات خادم SFTP الخاص بالخلاصة في قسم الإعدادات > الخلاصات في "بوابة الشريك".

اختيار خادم بروتوكول النقل الآمن للملفات (SFTP) الخاص بالخلاصة

الشكل 1: معلومات عامة عن خادم بروتوكول النقل الآمن للملفات (SFTP)

يمكن الاطّلاع على حالة استيعاب الخلاصة في القسم الاستيعاب > السجلّ في "بوابة الشريك". يمكن العثور على معلومات خادم SFTP الخاص بالخلاصة في قسم الإعدادات > الخلاصات في "بوابة الشريك".

التعامل مع خيارات عناصر القائمة

يمكن تحديد خيارات عناصر القائمة باستخدام MenuItemOption proto.

على الشركاء الذين لديهم مجموعات متعدّدة من الخيارات المطلوبة لعنصر قائمة واحد (مثل لاتيه مع خيارات الحجم وخيارات الحليب) تحديد أفضل طريقة لعرض هذه الخيارات في Google. تنصح Google بما يلي:

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

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

المطاعم التي تتضمّن قوائم طعام متعدّدة

يمكن أن يكون لمطعم واحد (كيان) قائمة طعام واحدة فقط. بالنسبة إلى المطعم الذي يتضمّن قوائم متعددة (أي قوائم غداء وعشاء منفصلة)، يمكنك دمج جميع القوائم في قائمة واحدة باستخدام MenuSections (أي قائمة واحدة تتضمّن قسمًا للغداء وقسمًا للعشاء). ستتضمّن القائمة الناتجة البنية التالية:

  • القائمة
    • قسم الغداء
      • حساء
        • الحساء 1
        • الحساء 2
      • سندويتشات
        • ساندويتش 1
        • ساندويتش 2
    • قسم العشاء
      • المقبلات
        • Starter 1
        • Starter 2
      • الأطباق الرئيسية
        • الطبق الرئيسي 1
        • الطبق الرئيسي 2

مشاركة قوائم الطعام بين المطاعم

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

أفضل الممارسات

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

  • ربط قائمة طعام واحدة فقط بمطعم
  • قدِّم اللغة المفضّلة كلغة أولى في TextField. في حال إرسال عناصر LocalizedText متعددة، سيتم عرض العنصر الأول في قائمة النصوص للمستخدمين.
  • يجب إضافة جميع أصناف القائمة إلى أقسام القائمة. لا تُضِف عناصر القائمة مباشرةً إلى عنصر القائمة.
  • قدِّم المحتوى باستخدام ترميز utf-8. ليس من الضروري إلغاء الأحرف غير ASCII.
  • إذا كنت ستطلق تطبيقك في مناطق متعددة، تأكَّد من استخدام رموز العملات والقيم الصحيحة في حقلَي الوحدات والنانو، مع إيلاء اهتمام خاص لحقل النانو الذي يمثّل 10^-9 من الوحدة. استخدِم "أداة عرض قائمة الأسعار" في عارض المستودع الإعلاني للتأكّد من أنّك ضبطت الأسعار بشكل صحيح.
  • إنّ توفير قوائم غنية بالصور ووافية ومتجددة للمستخدمين هو أمر أساسي لتقديم تجربة مفيدة وجذابة. يجب أن تعرض القوائم الأسعار والأوصاف والصور والمعلومات الغذائية، فهي عناصر أساسية في التشجيع على اتّخاذ القرار، وننصح الشركاء بتقديم أكبر قدر ممكن من هذه البيانات لتوفير تجربة مثالية للمستخدمين والتجّار.
  • لعرض منتج بدون سعر، أدرِج بروتوكول السعر فارغًا في بروتوكول العرض.

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

مثال على قائمة طعام تعرض أصنافًا مع أوصاف

الشكل 3: مثال على كيفية عرض محتوى خلاصة القائمة في "الملف التجاري" على الأجهزة الجوّالة

لضمان تنظيم قائمة الطعام بشكل صحيح، استخدِم "أداة عرض قائمة الطعام" في عارض المستودع لمعاينة قوائم الطعام.

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

المخطط

يمكنك الاطّلاع على مخطط القائمة الكامل هنا.

FoodMenuFeed

اسم الحقلالنوعالمتطلباتالوصف
dataمصفوفة تتضمّن عناصر
(MenuComponent)

اسم الحقلالنوعالمتطلباتالوصف
oneOf
(type)

لا يمكن ضبط سوى حقل واحد من الحقول في هذا oneOf.

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

اسم الحقلالنوعالمتطلباتالوصف
menu_idسلسلة

مطلوب

سلسلة غير شفافة من شريك تحدّد بشكل فريد القائمة ضمن خلاصة الشريك. الحقل مطلوب.
merchant_idsمصفوفة من السلاسل

مطلوب

التجّار الذين تنطبق عليهم القائمة ملاحظة: يتم تكرار هذا الحقل حتى تتمكّن المطاعم التابعة لسلسلة من مشاركة قائمة الطعام نفسها في مواقع جغرافية متعددة، كل منها عبارة عن تاجر منفصل. الحقل مطلوب.
display_nameالكائن
(TextField)

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

رمز اللغة التلقائي المرتبط بالتصنيفات النصية الواردة في القائمة يجب أن يكون رمز اللغة وفق معيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. اختياريّ.

TextField

حمولة نصية تحتوي على قيمة واحدة أو أكثر من القيم المترجمة

اسم الحقلالنوعالمتطلباتالوصف
textمصفوفة تتضمّن عناصر
(LocalizedText)

مطلوب

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

LocalizedText

نسخة مترجَمة من نص بلغة معيّنة

اسم الحقلالنوعالمتطلباتالوصف
textسلسلة

سلسلة مترجَمة باللغة المتوافقة مع [language_code][google.type.LocalizedText.language_code] أدناه.
language_codeسلسلة

تمثّل هذه السمة رمز اللغة المستخدَمة في النص وفق المعيار BCP-47، مثل "en-US" أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

قسم القائمة هو مجموعة من العناصر في قائمة. يتم عادةً إنشاء MenuSections منفصلة لكل مجموعة منطقية من العناصر في القائمة. على سبيل المثال، تشمل الأقسام النموذجية نوع وجبة الطعام (مقبلات، طبق رئيسي، حلوى) وفئات الطعام (برغر، مشروبات).

اسم الحقلالنوعالمتطلباتالوصف
menu_section_idسلسلة

مطلوب

تمثّل هذه السمة سلسلة غير شفافة من شريك تحدّد MenuSection بشكل فريد ضمن خلاصة الشريك. الحقل مطلوب.
display_nameالكائن
(TextField)

مطلوب

الاسم الذي يمكنه تحديد MenuSection عندما يتصفّح المستخدم القائمة. الحقل مطلوب.
descriptionالكائن
(TextField)

تمثّل هذه السمة وصفًا لقسم القائمة. اختياريّ.
imagesمصفوفة تتضمّن عناصر
(Image)

صور قسم القائمة اختياريّ.

صورة

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

اسم الحقلالنوعالمتطلباتالوصف
uriسلسلة

مطلوب

عنوان URL يحتوي على وحدات البكسل الأولية للصورة. الحقل مطلوب.

تمثّل هذه الفئة عنصرًا واحدًا من الأطعمة أو المشروبات التي تقدّمها مؤسسة غذائية.

اسم الحقلالنوعالمتطلباتالوصف
menu_item_idسلسلة

مطلوب

تمثّل هذه السمة سلسلة مبهمة من الشريك تحدّد بشكلٍ فريد MenuItem ضمن خلاصة الشريك. الحقل مطلوب.
display_nameالكائن
(TextField)

مطلوب

الاسم الذي يمكنه تحديد MenuItem عندما يتصفّح المستخدم القائمة الحقل مطلوب.
descriptionالكائن
(TextField)

تمثّل هذه السمة وصفًا لعنصر القائمة. اختياريّ.
imagesمصفوفة تتضمّن عناصر
(Image)

صور عنصر القائمة اختياريّ.
oneOf
(pricing)

مطلوب

لا يمكن ضبط سوى حقل واحد من الحقول في هذا oneOf.
item_attributesالكائن
(MenuItemAttributes)

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

OfferSet

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

اسم الحقلالنوعالمتطلباتالوصف
offersمصفوفة تتضمّن عناصر
(Offer)

مطلوب

قائمة بالعروض الترويجية المحتملة الحقل مطلوب.

عرض

تمثّل هذه السمة معلومات الأسعار ومدى التوفّر الخاصة بـ MenuItems وMenuItemOptions.

اسم الحقلالنوعالمتطلباتالوصف
priceالكائن
(Money)

الحالات التالية غير صالحة وستؤدي إلى إزالة عنصر القائمة: السعر بدون رمز عملة ولكن مع وحدة أو نانو أو كليهما: price {units: 100, nanos: 1000000} price {units: 100} price {nanos: 1000000} السعر مع رمز عملة غير صالح ولكن مع وحدة أو نانو أو كليهما: price {currency_code: 'gXYZ', units: 100, nanos: 1000000} price {currency_code: 'gXYZ', units: 100} price {currency_code: 'gXYZ', nanos: 1000000} السعر مع رمز عملة ولكن بوحدات أو نانو غير صالحَين price {currency_code: 'USD', units: 100, nanos: -100} price {currency_code: 'USD', units: -100, nanos: 100}

المال

تمثّل هذه السمة مبلغًا من المال مع نوع العملة.

اسم الحقلالنوعالمتطلباتالوصف
currency_codeسلسلة

تمثّل هذه السمة رمز العملة المكوّن من ثلاثة أحرف والمحدّد في معيار ISO 4217.
unitsسلسلة

تمثّل هذه السمة الوحدات الكاملة للمبلغ. على سبيل المثال، إذا كانت قيمة currencyCode هي "USD"، تكون الوحدة الواحدة هي دولار أمريكي واحد.
nanosالرقم

عدد وحدات النانو (10^-9) من المبلغ. يجب أن تتراوح القيمة بين ‎-999,999,999 و‎+999,999,999، بما في ذلك طرفي النطاق. إذا كانت قيمة units موجبة، يجب أن تكون قيمة nanos موجبة أو صفرًا. إذا كانت قيمة units صفرًا، يمكن أن تكون قيمة nanos موجبة أو صفرًا أو سالبة. إذا كانت قيمة units سالبة، يجب أن تكون قيمة nanos سالبة أو صفرًا. على سبيل المثال، يتم تمثيل القيمة ‎ $-1.75 على النحو التالي: units=-1 وnanos=-750,000,000.

حاوية تحدّد قائمة بالخيارات المتاحة في منتج أو خدمة

اسم الحقلالنوعالمتطلباتالوصف
menu_item_option_idsمصفوفة من السلاسل

مطلوب

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

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

اسم الحقلالنوعالمتطلباتالوصف
number_of_servingsالرقم

تمثّل هذه السمة عدد الوجبات المتوفرة في قائمة طعام معيّنة. اختياريّ.
nutrition_informationالكائن
(NutritionInformation)

تصف هذه السمة جميع المعلومات الغذائية الخاصة بالمنتج، مثل السعرات الحرارية ومحتوى الدهون. اختياريّ.
suitable_dietsمصفوفة من قيم التعداد
(DietaryRestriction)

القيود الغذائية التي يتوافق معها عنصر قائمة الطعام هذا اختياريّ.
additiveمصفوفة تتضمّن عناصر
(Additive)

المواد المضافة إلى هذا العنصر في القائمة اختياريّ.
allergenمصفوفة تتضمّن عناصر
(Allergen)

مسبّبات الحساسية في هذا العنصر من القائمة اختياريّ.
packaging_deposit_infoالكائن
(DepositInfo)

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

NutritionInformation

تصف هذه السمة جميع القياسات الغذائية الخاصة بـ MenuItem أو الإضافات.

اسم الحقلالنوعالمتطلباتالوصف
energyالكائن
(NutritionValue)

تمثّل هذه السمة مقدار الطاقة الغذائية في وجبة الطعام. يمكن تحديدها بالسعرات الحرارية أو الكيلوجول. اختياريّ.
sodium_contentالكائن
(NutritionValue)

كمية الصوديوم، ويتم قياسها بالغرام أو الملّيغرام اختياريّ.
serving_sizeالرقم

تمثّل هذه السمة عدد الحصص التي تنطبق عليها القيمة الغذائية. اختياريّ.
descriptionالكائن
(TextField)

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

NutritionValue

تصف هذه السمة قياسًا غذائيًا واحدًا لوجبة الطعام.

اسم الحقلالنوعالمتطلباتالوصف
oneOf
(value)

لا يمكن ضبط سوى حقل واحد من الحقول في هذا oneOf.
unitenum
(NutritionValueUnit)

مطلوب

وحدة القياس المرتبطة بالمبلغ كما يحدّدها الشريك سنتأكّد من صحة الخلاصة لضمان توفّر وحدة لكل نوع من القيم الغذائية. على سبيل المثال، من المتوقّع استخدام ENERGY_CALORIES وENERGY_KILOJOULES فقط في سمة الطاقة ضمن NutritionalInformation. الحقل مطلوب.

النطاق

تصف هذه السمة نطاقًا مغلقًا لقيمة التغذية. مثال: "من 100 إلى 150 سعرة حرارية"

اسم الحقلالنوعالمتطلباتالوصف
minالرقم

مطلوب

تمثّل هذه السمة الحدّ الأدنى لقيمة التغذية. الحقل مطلوب.
maxالرقم

مطلوب

تمثّل هذه السمة الحد الأقصى لقيمة التغذية. الحقل مطلوب.

مادة مضافة

تمثّل هذه السمة الإضافة المعروضة للمستخدم في MenuItem. المادة المضافة هي مادة تحافظ على جودة الطعام أو تحسّنها.

اسم الحقلالنوعالمتطلباتالوصف
nameالكائن
(TextField)

مطلوب

النص الوصفي للمادة المضافة، مثل "المواد الحافظة" الحقل مطلوب.
containment_level_codeenum
(ContainmentLevelCode)

تحدّد هذه السمة ما إذا كان MenuItem يتضمّن هذه المادة المضافة أو قد يتضمّنها أو لا يتضمّنها. القيمة التلقائية هي "يحتوي على". اختياريّ.

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

مادة مسبّبة للحساسية معروضة للمستخدم في MenuItem. يشير مصطلح "مادة مسبّبة للحساسية" إلى صفات الطعام التي تسبّب تفاعلات تحسّسية.

اسم الحقلالنوعالمتطلباتالوصف
allergen_type_codeenum
(AllergenTypeCode)

مطلوب

نوع مسبّب الحساسية الحقل مطلوب.
containment_level_codeenum
(ContainmentLevelCode)

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

DepositInfo

معلومات الإيداع التي يقدّمها الشريك لتوجيه المستخدم بشأن كيفية إيداع عبوة طعام أو زجاجة وقيمة هذا الإيداع

اسم الحقلالنوعالمتطلباتالوصف
deposit_codeenum
(DepositCode)

استراتيجية الإيداع التي سيتم استخدامها، مثل "قابلة لإعادة الاستخدام". اختياريّ.
deposit_valueالكائن
(Money)

القيمة التي تم ردّها مقابل إيداع السلعة بشكل صحيح اختياريّ.

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

اسم الحقلالنوعالمتطلباتالوصف
menu_item_option_idسلسلة

مطلوب

سلسلة مبهمة من شريك تحدّد بشكل فريد MenuItemOption ضمن خلاصة الشريك. الحقل مطلوب.
valueالكائن
(MenuItemOptionProperty)

مطلوب

سمة الخيار وقيمته، مثل "المقاس: صغير" الحقل مطلوب.

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

اسم الحقلالنوعالمتطلباتالوصف
property_typeenum
(PropertyType)

مطلوب

تمثّل هذه السمة نوع خيار المنتج. الحقل مطلوب.
oneOf
(value)

مطلوب

لا يمكن ضبط سوى حقل واحد من الحقول في هذا oneOf.

NutritionValueUnit

الاسمالوصف
NUTRITION_VALUE_UNIT_UNSPECIFIEDلا تستخدم هذه السمة. لم يتم تحديد وحدة القيمة الغذائية بشكلٍ صريح.
ENERGY_CALORIESوحدات مستخدَمة للتعبير عن مقدار الطاقة في أحد عناصر القائمة
ENERGY_KILOJOULES
WEIGHT_MILLIGRAMSتمثّل هذه السمة الوحدات المستخدَمة للتعبير عن كمية المادة الموجودة في قائمة الطعام.
WEIGHT_GRAMS

DietaryRestriction

تشير هذه السمة إلى القيود أو الإرشادات الغذائية التي يتم الالتزام بها أثناء تحضير الطعام.

الاسمالوصف
DIET_UNSPECIFIEDلا تستخدم هذه السمة. لم يتم تحديد القيود الغذائية بشكل صريح.
DIET_DIABETIC
DIET_GLUTEN_FREE
DIET_HALAL
DIET_HINDU
DIET_KOSHER
DIET_LOW_CALORIE
DIET_LOW_FAT
DIET_LOW_LACTOSE
DIET_LOW_SALT
DIET_VEGAN
DIET_VEGETARIAN

ContainmentLevelCode

تشير إلى مستوى احتواء منتج غذائي على سمة معيّنة، مثل المواد المسبِّبة للحساسية أو المواد المضافة.

الاسمالوصف
CONTAINMENT_LEVEL_CODE_UNSPECIFIEDلا تستخدم هذه السمة. لم يتم تحديد رمز مستوى الاحتواء بشكل صريح.
CONTAINMENT_LEVEL_CODE_CONTAINS
CONTAINMENT_LEVEL_CODE_DOES_NOT_CONTAIN
CONTAINMENT_LEVEL_CODE_MAY_CONTAIN

AllergenTypeCode

نوع مادة مسبّبة للحساسية مشتق من GS1: http://gs1.org/voc/AllergenTypeCode

الاسمالوصف
ALLERGEN_TYPE_CODE_UNSPECIFIEDلا تستخدم هذه السمة. لم يتم تحديد رمز نوع مادة مسببة للحساسية بشكل واضح.
ALLERGEN_TYPE_CODE_ALMONDS
ALLERGEN_TYPE_CODE_ALPHA_ISOMETHYL_IONONE
ALLERGEN_TYPE_CODE_ALCOHOL
ALLERGEN_TYPE_CODE_AMYL_CINNAMAL
ALLERGEN_TYPE_CODE_ANISE_ALCOHOL
ALLERGEN_TYPE_CODE_BARLEY
ALLERGEN_TYPE_CODE_BENZYL_ALCOHOL
ALLERGEN_TYPE_CODE_BENZYL_BENZOATE
ALLERGEN_TYPE_CODE_BENZYL_CINNAMATE
ALLERGEN_TYPE_CODE_BENZYL_SALICYLATE
ALLERGEN_TYPE_CODE_BRAZIL_NUTS
ALLERGEN_TYPE_CODE_BUTYLPHENYL_METHYLPROPIONATE
ALLERGEN_TYPE_CODE_CARROTS
ALLERGEN_TYPE_CODE_CASHEW_NUTS
ALLERGEN_TYPE_CODE_CELERY
ALLERGEN_TYPE_CODE_CEREALS_CONTAINING_GLUTEN
ALLERGEN_TYPE_CODE_CINNAMAL
ALLERGEN_TYPE_CODE_CINNAMYL_ALCOHOL
ALLERGEN_TYPE_CODE_CITRAL
ALLERGEN_TYPE_CODE_CITRONELLOL
ALLERGEN_TYPE_CODE_COCOA
ALLERGEN_TYPE_CODE_CORIANDER
ALLERGEN_TYPE_CODE_CORN
ALLERGEN_TYPE_CODE_COUMARIN
ALLERGEN_TYPE_CODE_CRUSTACEANS
ALLERGEN_TYPE_CODE_EGGS
ALLERGEN_TYPE_CODE_EUGENOL
ALLERGEN_TYPE_CODE_EVERNIA_FURFURACEA
ALLERGEN_TYPE_CODE_EVERNIA_PRUNASTRI
ALLERGEN_TYPE_CODE_FARNESOL
ALLERGEN_TYPE_CODE_FISH
ALLERGEN_TYPE_CODE_GERANIOL
ALLERGEN_TYPE_CODE_GLUTEN
ALLERGEN_TYPE_CODE_HAZELNUTS
ALLERGEN_TYPE_CODE_HEXYL_CINNAMAL
ALLERGEN_TYPE_CODE_HYDROXYCITRONELLAL
ALLERGEN_TYPE_CODE_HYDROXYISOHEXYL_3_CYCLOHEXENE_CARBOXALDEHYDE_ISOEUGENOL_LIMONENE_LINAL
ALLERGEN_TYPE_CODE_KAMUT
ALLERGEN_TYPE_CODE_LACTOSE
ALLERGEN_TYPE_CODE_LUPINE
ALLERGEN_TYPE_CODE_MACADAMIA_NUTS
ALLERGEN_TYPE_CODE_METHYL_2_OCTYNOATE
ALLERGEN_TYPE_CODE_MILK
ALLERGEN_TYPE_CODE_MOLLUSCS
ALLERGEN_TYPE_CODE_MUSTARD
ALLERGEN_TYPE_CODE_NO_DECLARED_ALLERGENS
ALLERGEN_TYPE_CODE_OAT
ALLERGEN_TYPE_CODE_PEANUTS
ALLERGEN_TYPE_CODE_PEAS
ALLERGEN_TYPE_CODE_PECAN_NUTS
ALLERGEN_TYPE_CODE_PISTACHIOS
ALLERGEN_TYPE_CODE_POD_FRUITS
ALLERGEN_TYPE_CODE_QUEENSLAND_NUTS
ALLERGEN_TYPE_CODE_RYE
ALLERGEN_TYPE_CODE_SESAME_SEEDS
ALLERGEN_TYPE_CODE_SOYBEANS
ALLERGEN_TYPE_CODE_SPELT
ALLERGEN_TYPE_CODE_SULPHUR_DIOXIDE
ALLERGEN_TYPE_CODE_TREE_NUTS
ALLERGEN_TYPE_CODE_TREE_NUT_TRACES
ALLERGEN_TYPE_CODE_WALNUTS
ALLERGEN_TYPE_CODE_WHEAT

DepositCode

تشير إلى كيفية إيداع عبوة أو منتج غذائي بشكل صحيح.

الاسمالوصف
DEPOSIT_CODE_UNSPECIFIEDلا تستخدم هذه السمة. لم يتم تحديد رمز الإيداع بشكل صريح.
DEPOSIT_CODE_REUSABLE
DEPOSIT_CODE_RECYCLABLE

PropertyType

أنواع العقارات التي ينطبق عليها الخيار

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

PropertyValue

قيم محددة جيدًا لسمة الخيار

الاسمالوصف
UNKNOWN_PROPERTY_VALUEلا تستخدم هذه السمة. لم يتم تحديد قيمة السمة بشكل صريح.
PIZZA_SIDE_LEFTلا ينطبق MenuItemOption إلا على الجانب الأيسر من البيتزا.
PIZZA_SIDE_RIGHTلا ينطبق MenuItemOption إلا على الجانب الأيمن من البيتزا.
PIZZA_SIDE_WHOLEينطبق MenuItemOption على البيتزا بأكملها.

النوع

اسم الحقلالنوعالمتطلباتالوصف
menuالكائن
(Menu)

لا يمكن استخدامها مع section أو item أو option

sectionالكائن
(MenuSection)

لا يمكن استخدامها مع menu أو item أو option

itemالكائن
(MenuItem)

لا يمكن استخدامها مع menu أو section أو option

optionالكائن
(MenuItemOption)

لا يمكن استخدامها مع menu أو section أو item

التسعير

يجب أن يتضمّن عنصر القائمة سعرًا أو مجموعة من خيارات عنصر القائمة. الحقل مطلوب.

اسم الحقلالنوعالمتطلباتالوصف
offer_setالكائن
(OfferSet)

لا يمكن استخدامها مع menu_item_option_set

تمثّل هذه السمة العروض المتاحة لشراء هذا المنتج الغذائي.
menu_item_option_setالكائن
(MenuItemOptionSet)

لا يمكن استخدامها مع offer_set

الخيارات المتاحة لعنصر القائمة هذا

القيمة

Required oneof.

اسم الحقلالنوعالمتطلباتالوصف
amountالرقم

لا يمكن استخدامها مع range

تمثّل هذه السمة رقمًا واحدًا يمثّل مقدار القيمة الغذائية.
rangeالكائن
(Range)

لا يمكن استخدامها مع amount

نطاق يمثّل مقدار القيمة الغذائية

القيمة

الحقل مطلوب.

اسم الحقلالنوعالمتطلباتالوصف
property_valenum
(PropertyValue)

لا يمكن استخدامها مع text_val

قيمة محددة جيدًا لسمة الخيار لا يُتوقّع ظهورها حاليًا إلا إذا كانت قيمة property_type هي PIZZA_SIDE.
text_valالكائن
(TextField)

لا يمكن استخدامها مع property_val

نص حر لقيمة السمة يجب أن تكون قيمة property_type OPTION وSIZE.