نظرة عامة

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

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

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

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

عند إنشاء "خلاصات قوائم الطعام" وتحميلها، اتّبِع الإرشادات والاصطلاحات التالية:
  • لتقديم تفاصيل المطعم، اتّبِع مواصفات البيانات الموضّحة في خلاصة التاجر. للاطّلاع على مثال لملف 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 الخاصة بقائمة الطعام. يُرجى العِلم أنّ هذه القائمة تقبل معرّفات الكيانات للشركاء الذين يستخدمون خلاصة الكيان.

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

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

  • يمكن ربط قائمة طعام واحدة فقط بمطعم.
  • يُسمح بإضافة 3,000 عنصر MenuItem فريد كحد أقصى في الإجمالي (في جميع الأقسام والأقسام الفرعية المتداخلة).
  • يُسمح بحد أقصى يبلغ 100,000 عنصر فريد لكل نوع من أنواع العناصر (MenuSection أو MenuItem أو MenuItemOption) ضمن Menu واحد.
  • يجب ألا يتجاوز حجم Menu المجمّع بالكامل (مع جميع أقسامه وعناصره وخياراته المجمّعة بعد إزالة التكرار) 3.8 ميغابايت.
  • يجب أن تتضمّن جميع حقول المعرّف (menu_id وmerchant_ids وmenu_section_ids وmenu_item_ids وmenu_item_option_ids وaddon_menu_section_ids) 580 حرفًا أو أقل.
  • قدِّم اللغة المفضّلة كلغة أولى في TextField. في حال إرسال عناصر LocalizedText متعددة، سيتم عرض العنصر الأول في قائمة النصوص للمستخدمين.
  • يجب إضافة جميع أصناف القائمة إلى أقسام القائمة. لا تُضِف عناصر القائمة مباشرةً إلى عنصر القائمة.
  • قدِّم المحتوى باستخدام ترميز utf-8. ليس من الضروري تخطّي الأحرف غير ASCII.
  • إذا كنت ستطلق تطبيقك في مناطق متعددة، تأكَّد من استخدام رموز العملات والفئات الصحيحة في الحقلَين "الوحدات" و"النانو"، مع إيلاء اهتمام خاص للحقل "النانو" الذي يمثّل 10^-9 من الوحدة. استخدِم "أداة عرض قائمة الأسعار" في عارض المستودع الإعلاني للتأكّد من ضبط الأسعار بشكلٍ صحيح.
  • إنّ توفير قوائم غنية بالمعلومات ووافية ومتجددة للمستخدمين هو أمر أساسي لتقديم تجربة مفيدة وجذابة. يجب أن تعرض القوائم الأسعار والأوصاف والصور والمعلومات الغذائية، فهي عناصر أساسية في التشجيع على اتّخاذ القرار، وننصح الشركاء بتقديم أكبر قدر ممكن من هذه البيانات لتوفير تجربة مثالية للمستخدمين والتجّار.
  • لعرض سعر غير متوفّر، أدرِج Price proto فارغًا في Offer proto.

بعد إطلاق خلاصات قوائم الطعام، ستكون بيانات خلاصة قائمة الطعام مؤهّلة للظهور في تجارب الاستكشاف وقد تكون مرئية في علامة التبويب "قائمة الطعام" في ورقة بيانات المطعم. تتوفّر علامة التبويب الخاصة بقائمة الطعام على "بحث 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سمة خاصة بالبيتزا على سبيل المثال، لا يكون MenuItemOption صالحًا إلا لجزء من البيتزا أو بيتزا كاملة، مثل إضافة الفطر على الجانب الأيمن أو الأيسر أو على البيتزا بأكملها.

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

نص حر لقيمة السمة. متوقّع لسمتَي OPTION وSIZE الخاصتَين بـ property_type.