סקירה כללית

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

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

שם השדהTypeדרישהDescription
dataמערך של אובייקט
(MenuComponent)

שם השדהTypeדרישהDescription
oneOf
(type)

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

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

שם השדהTypeדרישהDescription
menu_idמחרוזת

נדרש

מחרוזת אטומה משותף שמזהה באופן ייחודי את התפריט בפיד של השותף. חובה.
merchant_idsarray of string

נדרש

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

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

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

TextField

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

שם השדהTypeדרישהDescription
textמערך של אובייקט
(LocalizedText)

נדרש

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

LocalizedText

גרסה מקומית של טקסט בשפה מסוימת.

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

שם השדהTypeדרישהDescription
menu_section_idמחרוזת

נדרש

מחרוזת אטומה משותף שמזהה באופן ייחודי את MenuSection בפיד של השותף. חובה.
display_nameאובייקט
(TextField)

נדרש

השם שיכול לזהות את MenuSection כשמשתמש מעיין בתפריט. חובה.
descriptionאובייקט
(TextField)

תיאור של קטע התפריט. אופציונלי.
imagesמערך של אובייקט
(Image)

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

תמונה

מייצג תמונה שמשויכת לישות של תפריט.

שם השדהTypeדרישהDescription
uriמחרוזת

נדרש

כתובת ה-URL שמכילה את הפיקסלים הגולמיים של התמונה. חובה.

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

שם השדהTypeדרישהDescription
menu_item_idמחרוזת

נדרש

מחרוזת אטומה משותף שמזהה באופן ייחודי את MenuItem בפיד של השותף. חובה.
display_nameאובייקט
(TextField)

נדרש

השם שמזהה את פריט התפריט כשמשתמש מעיין בתפריט. חובה.
descriptionאובייקט
(TextField)

תיאור של הפריט בתפריט. אופציונלי.
imagesמערך של אובייקט
(Image)

תמונות של המנה בתפריט. אופציונלי.
oneOf
(pricing)

נדרש

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

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

OfferSet

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

שם השדהTypeדרישהDescription
offersמערך של אובייקט
(Offer)

נדרש

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

מבצע

מייצג מידע על תמחור וזמינות של MenuItems ו-MenuItemOptions.

שם השדהTypeדרישהDescription
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}

כסף

מייצג סכום כסף עם סוג המטבע.

שם השדהTypeדרישהDescription
currency_codeמחרוזת

קוד המטבע בן שלוש אותיות כפי שמוגדר בתקן ISO 4217.
unitsמחרוזת

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

מספר יחידות הננו (10‎^-9) של הסכום. הערך חייב להיות בין ‎-999,999,999 ל- ‎+999,999,999, כולל. אם הערך של units הוא חיובי, הערך של nanos חייב להיות חיובי או אפס. אם הערך של units הוא אפס, הערך של nanos יכול להיות חיובי, אפס או שלילי. אם הערך של units הוא שלילי, הערך של nanos חייב להיות שלילי או אפס. לדוגמה, הסכום ‎ $-1.75 מיוצג כ-units=-1 וגם כ-nanos=-750,000,000.

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

שם השדהTypeדרישהDescription
menu_item_option_idsarray of string

נדרש

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

מתאר מאפיינים של פריט או אפשרות מסוימים בתפריט.

שם השדהTypeדרישהDescription
number_of_servingsnumber

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

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

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

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

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

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

NutritionInformation

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

שם השדהTypeדרישהDescription
energyאובייקט
(NutritionValue)

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

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

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

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

NutritionValue

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

שם השדהTypeדרישהDescription
oneOf
(value)

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

נדרש

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

טווח

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

שם השדהTypeדרישהDescription
minnumber

נדרש

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

נדרש

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

תוסף

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

שם השדהTypeדרישהDescription
nameאובייקט
(TextField)

נדרש

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

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

אלרגן

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

שם השדהTypeדרישהDescription
allergen_type_codeenum
(AllergenTypeCode)

נדרש

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

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

DepositInfo

השותף מספק מידע על פיקדון כדי להסביר למשתמש איך להפקיד פריט מזון או בקבוק, ומה ערך הפיקדון.

שם השדהTypeדרישהDescription
deposit_codeenum
(DepositCode)

שיטת ההפקדה שבה רוצים להשתמש, למשל 'אפשרות לשימוש חוזר'. אופציונלי.
deposit_valueאובייקט
(Money)

הערך של ההחזר הכספי על הפקדת הפריט בצורה תקינה. אופציונלי.

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

שם השדהTypeדרישהDescription
menu_item_option_idמחרוזת

נדרש

מחרוזת אטומה משותף שמזהה באופן ייחודי את MenuItemOption בפיד של השותף. חובה.
valueאובייקט
(MenuItemOptionProperty)

נדרש

מאפיין וערך של אפשרות, למשל: מידה: קטנה. חובה.

תיאור של מאפיין של אפשרות בתפריט והערך שלו.

שם השדהTypeדרישהDescription
property_typeenum
(PropertyType)

נדרש

סוג מאפיין האפשרות. חובה.
oneOf
(value)

נדרש

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

NutritionValueUnit

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

DietaryRestriction

המאפיין מציין הגבלה או הנחיה תזונתית שפועלים לפיהן במהלך הכנת האוכל.

שםDescription
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

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

שםDescription
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

שםDescription
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

מציין איך להניח פריט מזון או בקבוק בצורה נכונה.

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

PropertyType

סוגי הנכסים שהאפשרות רלוונטית לגביהם.

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

PropertyValue

ערכים מוגדרים היטב למאפיין האפשרות.

שםDescription
UNKNOWN_PROPERTY_VALUEאין להשתמש בו. ערך המאפיין לא צוין באופן מפורש.
PIZZA_SIDE_LEFTהתג MenuItemOption חל רק על החצי השמאלי של הפיצה.
PIZZA_SIDE_RIGHTהתג MenuItemOption רלוונטי רק לחצי הימני של הפיצה.
PIZZA_SIDE_WHOLEהמאפיין MenuItemOption חל על הפיצה כולה.

סוג

שם השדהTypeדרישהDescription
menuאובייקט
(Menu)

לא כולל section, item, option

sectionאובייקט
(MenuSection)

לא כולל menu, item, option

itemאובייקט
(MenuItem)

לא כולל menu, section, option

optionאובייקט
(MenuItemOption)

לא כולל menu, section, item

תמחור

פריט התפריט חייב לכלול מחיר או קבוצה של אפשרויות לפריט התפריט. חובה.

שם השדהTypeדרישהDescription
offer_setאובייקט
(OfferSet)

לא ניתן להשתמש בו עם menu_item_option_set

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

לא ניתן להשתמש בו עם offer_set

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

ערך

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

שם השדהTypeדרישהDescription
amountnumber

לא ניתן להשתמש בו עם range

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

לא ניתן להשתמש בו עם amount

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

ערך

חובה.

שם השדהTypeדרישהDescription
property_valenum
(PropertyValue)

לא ניתן להשתמש בו עם text_val

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

לא ניתן להשתמש בו עם property_val

טקסט חופשי לערך המאפיין. נדרש עבור property_type OPTION ו-SIZE.