סקירה כללית

שותפים של 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 של פיד כללי

סטטוס ההטמעה של הפיד מופיע בקטע Ingestion > History [הטמעה > היסטוריה] בפורטל השותפים. אפשר למצוא את פרטי שרת ה-SFTP של הפיד בקטע הגדרות > פידים בפורטל השותפים.

בחירת שרת SFTP של פיד

איור 1: פרטים כלליים של שרת SFTP

סטטוס ההעלאה של הפיד מופיע בקטע העלאה > היסטוריה בפורטל השותפים. אפשר למצוא את פרטי שרת ה-SFTP של הפיד בקטע הגדרות > פידים בפורטל השותפים.

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

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

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

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

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

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

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

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

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

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

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

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

  • אפשר לשייך רק תפריט אחד למסעדה.
  • מציינים את השפה המועדפת כשפה הראשונה ב-TextField. אם שולחים כמה אובייקטים מסוג LocalizedText, האובייקט הראשון ברשימת הטקסט מוצג למשתמשים.
  • כל הפריטים בתפריט צריכים להיות מתווספים לקטגוריות בתפריט. אל תוסיפו מנות ישירות לאובייקט התפריט.
  • צריך לספק תוכן בקידוד utf-8. אין צורך להשתמש בתו בריחה (escape) לתווים שאינם מסוג ASCII.
  • אם אתם משיקים בכמה אזורים, חשוב לוודא שאתם משתמשים בקודים ובערכים הנכונים של המטבע בשדות של היחידות והננו. שימו לב במיוחד לשדה הננו, שבו הערך הוא 10^-9 של יחידה. אפשר להשתמש בכלי להצגת תפריטים בכלי לבדיקת מלאי כדי לוודא שהגדרתם את המחירים בצורה נכונה.
  • כדי לספק חוויית משתמש מועילה ומושכת, חשוב להציג למשתמשים תפריטים עשירים מבחינה ויזואלית, מקיפים ועדכניים. מחירים, תיאורים, תמונות ומידע תזונתי הם מרכיבים חשובים מאוד בתהליך קבלת ההחלטות של הלקוחות, ולכן מומלץ לשותפים לספק כמה שיותר מהנתונים האלה כדי לספק חוויית משתמש ומוכר אופטימלית.
  • כדי לא להציג מחיר, צריך לכלול פרוטוקול Price ריק בפרוטוקול Offer.

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

מטען ייעודי (payload) של טקסט שמכיל ערך מקומי אחד או יותר.

שם השדהסוגדרישהתיאור
textמערך של אובייקט
(LocalizedText)

חובה

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

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

שם השדהסוגדרישהתיאור
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

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

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

חובה

רשימת המבצעים האפשריים. חובה.

מבצע

מייצג מידע על תמחור וזמינות של רכיבי MenuItem ו-MenuItemOption.

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

מספר היחידות השלמות של הסכום. לדוגמה: אם הערך של currencyCode הוא "USD", המשמעות היא ש-1 יחידה = 1 דולר ארה"ב.
nanosnumber

מספר יחידות הננו (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_servingsnumber

מספר המנות שזמינות בפריט מסוים בתפריט. אופציונלי.
nutrition_informationאובייקט
(NutritionInformation)

תיאור של כל המידע התזונתי של הפריט, למשל קלוריות, תכולת שומן. אופציונלי.
suitable_dietsמערך של enum
(DietaryRestriction)

ההגבלות התזונתיות שהפריט הזה בתפריט עומד בהן. אופציונלי.
additiveמערך של אובייקט
(Additive)

תוספים של הפריט הזה בתפריט. אופציונלי.
allergenמערך של אובייקט
(Allergen)

אלרגנים בפריט התפריט הזה. אופציונלי.
packaging_deposit_infoאובייקט
(DepositInfo)

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

NutritionInformation

תיאור של כל המדידות התזונתיות של פריט בתפריט או של תוסף.

שם השדהסוגדרישהתיאור
energyאובייקט
(NutritionValue)

כמות האנרגיה התזונתית במנת המזון. אפשר להגדיר את הערך בקלוריות או בקילוג'ול. אופציונלי.
sodium_contentאובייקט
(NutritionValue)

כמות הנתרן בתוכן, שנמדדת בגרמים או במיליגרמים. אופציונלי.
serving_sizenumber

מספר המנות שהערך התזונתי מתייחס אליהן. אופציונלי.
descriptionאובייקט
(TextField)

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

NutritionValue

מתאר מדידה תזונתית אחת של מנת מזון.

שם השדהסוגדרישהתיאור
oneOf
(value)

אפשר להגדיר רק אחד מהשדות ב-oneOf הזה.
unitenum
(NutritionValueUnit)

חובה

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

טווח

מתאר טווח סגור של ערך תזונתי. לדוגמה: ‎"100-150 cal"‎

שם השדהסוגדרישהתיאור
minnumber

חובה

הערך התזונתי המינימלי. חובה.
maxnumber

חובה

הערך התזונתי המקסימלי. חובה.

תוסף

תוספת שמוצגת למשתמש בפריט בתפריט. תוסף משמר או משפר את איכות המזון.

שם השדהסוגדרישהתיאור
nameאובייקט
(TextField)

חובה

טקסט תיאורי של התוסף, למשל 'חומרים משמרים'. חובה.
containment_level_codeenum
(ContainmentLevelCode)

אם הפריט בתפריט מכיל את התוסף הזה, עשוי להכיל אותו או שהוא לא מכיל אותו. ברירת המחדל היא contains. אופציונלי.

אלרגן

אלרגנים שמוצגים למשתמש בפריט התפריט. אלרגן הוא חומר במזון שגורם לתגובות אלרגיות.

שם השדהסוגדרישהתיאור
allergen_type_codeenum
(AllergenTypeCode)

חובה

סוג האלרגן. חובה.
containment_level_codeenum
(ContainmentLevelCode)

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

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

מבצעים זמינים לרכישת פריט המזון הזה.
menu_item_option_setאובייקט
(MenuItemOptionSet)

לא ניתן להשתמש ב-offer_set יחד עם offer_set

האפשרויות הזמינות לפריט התפריט הזה.

ערך

שדה חובה מסוג oneof.

שם השדהסוגדרישהתיאור
amountnumber

לא ניתן להשתמש ב-range יחד עם range

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

לא ניתן להשתמש ב-amount יחד עם amount

טווח שמייצג את כמות הערך התזונתי.

ערך

חובה.

שם השדהסוגדרישהתיאור
property_valenum
(PropertyValue)

לא ניתן להשתמש ב-text_val יחד עם text_val

ערך מוגדר היטב של מאפיין האפשרות. בשלב הזה, הערך הזה צפוי רק אם property_type הוא PIZZA_SIDE.
text_valאובייקט
(TextField)

לא ניתן להשתמש ב-property_val יחד עם property_val

טקסט חופשי לערך המאפיין. נדרש עבור מאפייני סוג הנכס [property_type], הווריאציות של מוצר [variant_option] והמידה [size].