סקירה כללית

שותפים של Google יכולים לספק ל-Google נתוני תפריט מובנים באמצעות השילוב של הזמנות מקצה לקצה, לשימוש בקטע תפריט בפרופיל העסק של מסעדה ב-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 של הפיד בקטע הגדרות > פידים בפורטל השותפים.

עבודה עם אפשרויות של פריטים בתפריט

אפשר לציין אפשרויות של פריטי תפריט באמצעות פרוטו MenuItemOption.

שותפים עם כמה קבוצות של אפשרויות חובה לפריט תפריט יחיד (לדוגמה, לאטה עם אפשרויות גודל ואפשרויות חלב) צריכים להחליט מהי הדרך הטובה ביותר להציג את האפשרויות האלה ב-Google. ‫Google ממליצה על הפעולות הבאות:

• הפיד של התפריט צריך להיות זהה לתפריט באתר ההזמנות של השותף (או לתפריט של המסעדה לאכילה במקום, אם אין לכם אתר הזמנות למיקום). אם הפריט מוצג עם מחיר נפרד באתר ההזמנה, צריך להשתמש ב-MenuItem. אם הפריט מוצג עם מחיר בסיס וכמה אפשרויות, צריך להשתמש ב-MenuItemOption.
• מומלץ להימנע מרשימה ארוכה של אפשרויות, למשל:
  • בוריטו עוף
  • בוריטו עוף עם גבינה
  • בוריטו עוף עם סלסה
  • בוריטו עוף עם סלסה וגבינה
  • בוריטו עוף עם גואקמולה
  • בוריטו עוף עם גואקמולה וסלסה
• אפשר להשתמש באפשרויות של פריטים בתפריט רק אם חובה לבחור אחת מהאפשרויות של המנה. לדוגמה, כשמזמינים פיצה, המידה היא אפשרות חובה. אפשרויות של פריטים בתפריט שמתייחסות לתוספות (למשל, 'אפשרות להוסיף אבוקדו') לא אפשריות ואסור לכלול אותן בפידים.

המחיר של אפשרות הפריט בתפריט צריך להיות המחיר המלא של הפריט עם האפשרות שנבחרה. צריך להגדיר את המחיר לפריט בתפריט או לאפשרויות שלו, אבל לא לשניהם.

מסעדות עם כמה תפריטים

למסעדה אחת (ישות) יכול להיות רק תפריט אחד. אם יש למסעדה כמה תפריטים (למשל, תפריט צהריים ותפריט ערב נפרדים), אפשר לשלב את כל התפריטים לתפריט אחד עם MenuSections (כלומר, תפריט אחד עם קטגוריה לצהריים וקטגוריה לערב). התפריט שיתקבל יהיה במבנה הבא:

• תפריט
• קטע ארוחת הצהריים
• מרקים
• מרק 1
• Soup 2
• כריכים
• כריך 1
• כריך 2
• הקטע 'ארוחת ערב'
• הרכב פותח
• Starter 1
• Starter 2
• מנות עיקריות
• מנה עיקרית 1
• מנה עיקרית 2

שיתוף תפריטים בין מסעדות

אפשר לשתף תפריט אחד בין כמה מסעדות על ידי הוספת כל המסעדות לרשימת merchant_ids של התפריט. שימו לב: הרשימה הזו מקבלת מזהי ישויות של שותפים שמשתמשים בפיד Entity.

שיטות מומלצות

ריכזנו כאן כמה שיטות מומלצות שכדאי לפעול לפיהן כשמפתחים פידים של תפריטים.

• אפשר לשייך רק תפריט אחד למסעדה.
• אפשר להוסיף עד 3,000 אובייקטים ייחודיים של MenuItem בסך הכול (בכל הקטעים ובקטעי המשנה המקוננים).
• אפשר להשתמש במקסימום 100,000 ישויות ייחודיות לכל סוג ישות (MenuSection, ‏ MenuItem, ‏ MenuItemOption) במסגרת Menu אחת.
• הגודל של Menu אחרי הרכבה מלאה (עם כל החלקים, הפריטים והאפשרויות שלו אחרי הסרת כפילויות) לא יכול לחרוג מ-3.8MB.
• כל שדות המזהה (menu_id, merchant_ids, menu_section_ids, menu_item_ids, menu_item_option_ids, addon_menu_section_ids) צריכים להכיל עד 580 תווים.
• מציינים את השפה המועדפת כשפה הראשונה ב-TextField. אם שולחים כמה אובייקטים מסוג LocalizedText, האובייקט הראשון ברשימת הטקסט מוצג למשתמשים.
• כל הפריטים בתפריט צריכים להיות מתווספים לקטגוריות בתפריט. אל תוסיפו מנות ישירות לאובייקט התפריט.
• צריך לספק תוכן בקידוד utf-8. אין צורך להשתמש בתו בריחה (escape) לתווים שהם לא-ASCII.
• אם אתם משיקים בכמה אזורים, חשוב לוודא שאתם משתמשים בקודי המטבע הנכונים ובערכים הנכונים בשדות של היחידות והננו-יחידות. שימו לב במיוחד לשדה של הננו-יחידות, שבו הערך הוא 10^-9 של יחידה. אפשר להשתמש בכלי להצגת תפריטים בכלי לבדיקת מלאי שטחי פרסום כדי לוודא שהגדרתם את המחירים בצורה נכונה.
• כדי לספק חוויית משתמש מועילה ומושכת, חשוב להציג למשתמשים תפריטים עשירים מבחינה ויזואלית, מקיפים ועדכניים. מחירים, תיאורים, תמונות ומידע על תזונה הם מרכיבים חשובים בתהליך קבלת ההחלטות של הלקוחות, ולכן מומלץ לספקים לספק כמה שיותר נתונים כאלה כדי לספק חוויית משתמש ומוכר אופטימלית.
• כדי לא להציג מחיר, צריך לכלול פרוטוקול Price ריק בפרוטוקול Offer.

כלי פיתוח ובדיקה

אחרי השקת פידים של תפריטים, נתוני הפיד של התפריט שלכם יהיו זמינים להצגה בממשקי גילוי, ועשויים להופיע בכרטיסייה 'תפריט' של המסעדה. הכרטיסייה 'תפריט' נתמכת בחיפוש Google (בנייד ובמחשב), והחוויה תורחב לפלטפורמות נוספות, כולל מפות Google. הממשק שיוצג עשוי להיות שונה בהתאם לפלטפורמה.

כדי לוודא שהתפריט בנוי בצורה נכונה, אפשר להשתמש בכלי להמחשת תפריטים בכלי לבדיקת מלאי שטחי פרסום כדי לראות תצוגה מקדימה של התפריטים.

תפריטים של מסעדות יכולים להגיע ממקורות רבים, כולל מהמסעדות עצמן דרך פרופיל העסק שלהן ב-Google, שותפים להזמנת אוכל ולהזמנת מקומות, תמונות של תפריטים שהועלו על ידי משתמשים ועוד. אם כמה מקורות מספקים תפריטים לאותה מסעדה, המוכר יכול לבחור ספק מועדף בכלי לעריכת תפריטים בפרופיל העסק ב-Google.

סכימה

סכימת התפריט המלאה זמינה כאן.

שם השדה	סוג	דרישה	תיאור
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. אופציונלי.

שם השדה	סוג	דרישה	תיאור
text	מערך של אובייקטים (LocalizedText)	חובה	ערכי טקסט לכל לוקאל. אם רוצים לתמוך רק באזור אחד, לא צריך להגדיר את language_code בכל טקסט, והשפה תוסק משפת ברירת המחדל של התפריט. אם יש כמה טקסטים באזורים שונים, צריך להגדיר את קוד השפה לכל טקסט. הטקסט הראשון ברשימה נחשב לייצוג המועדף. חובה.

שם השדה	סוג	דרישה	תיאור
text	מחרוזת		מחרוזת מותאמת לשפה שמתאימה ל[קוד השפה][google.type.LocalizedText.language_code] שבהמשך.
language_code	מחרוזת		קוד השפה של הטקסט בתקן BCP-47, למשל en-US או sr-Latn. מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

שם השדה	סוג	דרישה	תיאור
menu_section_id	מחרוזת	חובה	מחרוזת אטומה משותף שמזהה באופן ייחודי את MenuSection בפיד של השותף. חובה.
display_name	אובייקט (TextField)	חובה	השם שיכול לזהות את MenuSection כשמשתמש מעיין בתפריט. חובה.
description	אובייקט (TextField)		תיאור של קטע התפריט. אופציונלי.
images	מערך של אובייקטים (Image)		תמונה או תמונות של קטע בתפריט. אופציונלי.

שם השדה	סוג	דרישה	תיאור
uri	מחרוזת	חובה	כתובת URL שמכילה את הפיקסלים הגולמיים של התמונה. חובה.

שם השדה	סוג	דרישה	תיאור
menu_item_id	מחרוזת	חובה	מחרוזת אטומה משותף שמזהה באופן ייחודי את MenuItem בפיד של השותף. חובה.
display_name	אובייקט (TextField)	חובה	השם שמזהה את פריט התפריט כשמשתמש מעיין בתפריט. חובה.
description	אובייקט (TextField)		תיאור של הפריט בתפריט. אופציונלי.
images	מערך של אובייקטים (Image)		תמונה או תמונות של המנה בתפריט. אופציונלי.
	oneOf (pricing)	חובה	אפשר להגדיר רק אחד מהשדות ב-oneOf הזה.
item_attributes	אובייקט (MenuItemAttributes)		מאפיינים של פריט התפריט הזה. אופציונלי.

שם השדה	סוג	דרישה	תיאור
offers	מערך של אובייקטים (Offer)	חובה	רשימת המבצעים האפשריים. חובה.

שם השדה	סוג	דרישה	תיאור
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	number		מספר היחידות השלמות של הסכום. לדוגמה: אם הערך של currencyCode הוא "USD", המשמעות היא ש-1 יחידה = 1 דולר ארה"ב.
nanos	number		מספר יחידות הננו (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	number		מספר המנות שזמינות בפריט מסוים בתפריט. אופציונלי.
nutrition_information	אובייקט (NutritionInformation)		תיאור של כל המידע התזונתי של הפריט, למשל קלוריות, תכולת שומן. אופציונלי.
suitable_diets	מערך של enum (DietaryRestriction)		ההגבלות התזונתיות שהמנה הזו עומדת בהן. אופציונלי.
additive	מערך של אובייקטים (Additive)		תוספים של הפריט הזה בתפריט. אופציונלי.
allergen	מערך של אובייקטים (Allergen)		אלרגנים שקשורים לפריט הזה בתפריט. אופציונלי.
packaging_deposit_info	אובייקט (DepositInfo)		מידע על האריזה ועל המחזור של פריט התפריט הזה. אופציונלי.

שם השדה	סוג	דרישה	תיאור
energy	אובייקט (NutritionValue)		כמות האנרגיה התזונתית במנת המזון. אפשר להגדיר את הערך בקלוריות או בקילוג'ול. אופציונלי.
sodium_content	אובייקט (NutritionValue)		כמות הנתרן בתוכן, שנמדדת בגרמים או במיליגרמים. אופציונלי.
serving_size	number		מספר המנות שאליהן מתייחס הערך התזונתי. אופציונלי.
description	אובייקט (TextField)		מידע תזונתי בטקסט חופשי. לדוגמה, "מכיל חומרים משמרים". אופציונלי.

שם השדה	סוג	דרישה	תיאור
	oneOf (value)		אפשר להגדיר רק אחד מהשדות ב-oneOf הזה.
unit	enum (NutritionValueUnit)	חובה	היחידה שמשויכת לסכום כפי שצוין על ידי השותף. אנחנו נבדוק את הפיד כדי לוודא שהיחידה של כל סוג של ערך תזונתי היא היחידה הצפויה לסוג הערך הזה. לדוגמה, רק ENERGY_CALORIES ו-ENERGY_KILOJOULES צפויים במאפיין האנרגיה של NutritionalInformation. חובה.

שם השדה	סוג	דרישה	תיאור
min	number	חובה	הכמות המינימלית של ערך תזונתי. חובה.
max	number	חובה	הערך התזונתי המקסימלי. חובה.

שם השדה	סוג	דרישה	תיאור
name	אובייקט (TextField)	חובה	טקסט תיאורי של התוסף, למשל 'חומרים משמרים'. חובה.
containment_level_code	enum (ContainmentLevelCode)		האם הפריט בתפריט מכיל את התוסף הזה, עשוי להכיל אותו או לא מכיל אותו. ברירת המחדל היא contains. אופציונלי.

שם השדה	סוג	דרישה	תיאור
allergen_type_code	enum (AllergenTypeCode)	חובה	סוג האלרגן. חובה.
containment_level_code	enum (ContainmentLevelCode)		האם הפריט בתפריט מכיל את האלרגן הזה, עשוי להכיל אותו או שהוא לא מכיל אותו. ברירת המחדל היא contains. אופציונלי.

שם השדה	סוג	דרישה	תיאור
deposit_code	enum (DepositCode)		שיטת ההפקדה שבה רוצים להשתמש, לדוגמה: 'אפשרות לשימוש חוזר'. אופציונלי.
deposit_value	אובייקט (Money)		הערך של ההחזר הכספי על הפקדת הפריט בצורה תקינה. אופציונלי.

שם השדה	סוג	דרישה	תיאור
menu_item_option_id	מחרוזת	חובה	מחרוזת אטומה משותף שמזהה באופן ייחודי את MenuItemOption בפיד של השותף. חובה.
value	אובייקט (MenuItemOptionProperty)	חובה	מאפיין וערך של אפשרות, למשל: מידה: קטנה. חובה.

שם השדה	סוג	דרישה	תיאור
property_type	enum (PropertyType)	חובה	סוג מאפיין האפשרות הזה. חובה.
	oneOf (value)	חובה	אפשר להגדיר רק אחד מהשדות ב-oneOf הזה.

שם	תיאור
NUTRITION_VALUE_UNIT_UNSPECIFIED	אין להשתמש בו. יחידת הערך התזונתי לא מוגדרת באופן מפורש.
ENERGY_CALORIES	יחידות שמשמשות לציון כמות האנרגיה בפריט בתפריט.
ENERGY_KILOJOULES
WEIGHT_MILLIGRAMS	יחידות שמשמשות לציון הכמות של חומר מסוים בפריט בתפריט לפי משקל.
WEIGHT_GRAMS

שם	תיאור
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

שם	תיאור
CONTAINMENT_LEVEL_CODE_UNSPECIFIED	אין להשתמש בו. קוד רמת ההכלה לא צוין במפורש.
CONTAINMENT_LEVEL_CODE_CONTAINS
CONTAINMENT_LEVEL_CODE_DOES_NOT_CONTAIN
CONTAINMENT_LEVEL_CODE_MAY_CONTAIN

שם	תיאור
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

שם	תיאור
DEPOSIT_CODE_UNSPECIFIED	אין להשתמש בו. קוד ההפקדה לא צוין באופן מפורש.
DEPOSIT_CODE_REUSABLE
DEPOSIT_CODE_RECYCLABLE

שם	תיאור
UNKNOWN_PROPERTY_TYPE	אין להשתמש בו. סוג המאפיין לא צוין במפורש.
OPTION	מאפיין כללי של אפשרות לפריט בתפריט, שלא נכלל באחד מהסוגים הספציפיים יותר שמופיעים בהמשך. משתמשים במאפיין הזה אם סוג הנכס הוא לא SIZE או PIZZA_SIDE.
SIZE	מציין את מאפיין אפשרות הפריט בתפריט של הגודל (למשל, קטן, בינוני או גדול).
PIZZA_SIDE	מאפיין שספציפי לפיצות. לדוגמה: MenuItemOption הזה תקף רק למנה של פיצה, כמו תוספת פטריות בצד ימין, בצד שמאל או בכל הפיצה).

שם	תיאור
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	האפשרויות הזמינות לפריט התפריט הזה.

שם השדה	סוג	דרישה	תיאור
amount	number	לא ניתן להשתמש בו עם range	מספר יחיד שמייצג את הערך התזונתי.
range	אובייקט (Range)	לא ניתן להשתמש בו עם amount	טווח שמייצג את כמות הערך התזונתי.

שם השדה	סוג	דרישה	תיאור
property_val	enum (PropertyValue)	לא ניתן להשתמש בו עם text_val	ערך מוגדר היטב של מאפיין האפשרות. בשלב הזה, הערך הזה צפוי רק אם property_type הוא PIZZA_SIDE.
text_val	אובייקט (TextField)	לא ניתן להשתמש בו עם property_val	טקסט חופשי לערך המאפיין. נדרש עבור מאפיינים מסוג OPTION ו-SIZE.