עדכון תפריטי אוכל

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

כדי לעדכן את תפריטי האוכל של כרטיס מוצר, קודם צריך להתקשר אל accounts.locations.getFoodMenus. דוגמה לבקשה:

GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/foodMenus

התשובה מכילה ייצוג JSON של הנתונים הנוכחיים של כרטיס המוצר FoodMenus. משנים את האובייקט FoodMenus לפי הצורך ומפעילים את accounts.locations.updateFoodMenus. מידע נוסף זמין במאמר בנושא העלאה או החלפה של תפריטים.

אפשר להשתמש ב-Google My Business API כדי לעדכן את השדות הבאים:

שדות
שם	חובה שם הפריט, למשל Hamburger.
מחיר	חובה מחיר המאכל.
המטבע שבו מוצג המחיר	חובה המטבע של מחיר המזון, למשל U.S. dollar.
תיאור הפריט	אופציונלי תיאור קצר של פריט המזון.
סעיפי התפריט	אופציונלי קבוצות לוגיות של פריטי מזון, כמו Breakfast או Hamburger-Fries combo.
תזונה	אופציונלי (מומלץ) מידע תזונתי, כמו Total Fat=3g.
מספר האנשים שאמורים לקבל שירות	אופציונלי מספר האנשים שהמנה יכולה להספיק להם.
גודל המנה	אופציונלי כמות פריט המזון. לדוגמה, 8-piece of nuggets.
שיטות הכנה	אופציונלי שיטות ספציפיות להכנת המנה.
סגנונות בישול	אופציונלי (מומלץ) סוג המטבח הספציפי של פריט המזון.
חריפות	אופציונלי רמת החריפות של פריט המזון, למשל none,‏ mild,‏ medium ו-hot.
אלרגן	אופציונלי (מומלץ) אלרגנים במזון, כמו dairy,‏ egg,‏ fish,‏ peanut,‏ shellfish,‏ soy,‏ tree nut ו-wheat.
העדפות תזונתיות	אופציונלי (מומלץ) הגבלות תזונתיות של פריט המזון, כמו halal,‏ kosher,‏ organic,‏ vegan,‏ vegetarian,‏ gluten free ו-dairy free.
אפשרויות	אופציונלי סוג אפשרות האוכל, למשל chicken פאד תאי לעומת veggie פאד תאי.
תמונה של פריט מזון	אופציונלי תמונה של פריט המזון הספציפי.

העלאה או החלפה של תפריטי אוכל

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

כדי לבדוק אם מיקום מסוים עומד בדרישות, מתקשרים אל locations.get כדי לבדוק את Metadata. אם הערך של canHaveFoodMenus הוא true, אתם יכולים להעלות תפריטי אוכל.

אם המיקום שלכם עומד בדרישות, מבצעים PATCH שיחה אל accounts.locations.updateFoodMenus.

הנה דוגמה לבקשה שכוללת את כל השדות האופציונליים:

הערה: הוראות לצירוף תמונה לפריט מזון זמינות במאמר בנושא צירוף תמונות לפריט מזון.

PATCH
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/foodMenus

{
   "menus": [
       {
           "cuisines": [
                "AMERICAN"
            ],
           "labels": [
               {
                   "displayName": "Menu",
                   "description": "Main Menu of my Restaurant",
                   "languageCode": "en"
               }
           ],
           "sections": [
               {
                   "labels": {
                       "displayName": "Main Dishes",
                       "languageCode": "en"
                   },
                   "items": [
                       {
                           "labels": {
                               "displayName": "Dish1",
                               "description": "Dish1 - our original dish!",
                               "languageCode": "en"
                           },
                           "attributes": {
                               "price": {
                                   "currencyCode": "USD",
                                   "units": 20
                               },
                               "dietaryRestriction": "ORGANIC",
                               "nutritionFacts": {
                                   "calories": {
                                       "lowerAmount": 400,
                                       "upperAmount": 500,
                                       "unit": "CALORIE"
                                   },
                                   "totalFat": {
                                       "lowerAmount": 95,
                                       "upperAmount": 110,
                                       "unit": "GRAM"
                                   },
                                   "cholesterol": {
                                       "lowerAmount": 100,
                                       "upperAmount": 120,
                                       "unit": "MILLIGRAM"
                                   },
                                   "sodium": {
                                       "lowerAmount": 30,
                                       "upperAmount": 45,
                                       "unit": "MILLIGRAM"
                                   },
                                   "totalCarbohydrate": {
                                       "lowerAmount": 78,
                                       "upperAmount": 92,
                                       "unit": "MILLIGRAM"
                                   },
                                   "protein": {
                                       "lowerAmount": 25,
                                       "upperAmount": 35,
                                       "unit":"MILLIGRAM"
                                   }
                               },
                               "ingredients": [
                                   {
                                       "labels": [
                                           {
                                               "displayName": "Ingredient 1",
                                               "description": "Description for ingredient 1",
                                               "languageCode": "en"
                                           },
                                           {
                                               "displayName": "Ingredient 2",
                                               "languageCode": "en"
                                           }
                                       ]
                                   }
                               ],
                               "servesNumPeople": 1,
                               "preparationMethods": [
                                   "BAKED",
                                   "BOILED",
                                   "FRIED"
                               ],
                               "portionSize": {
                                   "quantity": 2,
                                   "unit": {
                                       "displayName": "Pieces",
                                       "languageCode": "en"
                                   }
                               },
                               "mediaKeys": [
                                   "AF1QipP_VOlJzXs2aOJ31234565cb2KPrvN"
                               ]
                           },
                           "options": [
                               {
                                   "labels":
                                       {
                                           "displayName": "Dish1 - spicy",
                                           "description": "Dish1 - a spicy version of our dish!",
                                           "languageCode": "en"
                                       },
                                   "attributes": {
                                       "price": {
                                           "currencyCode": "USD",
                                           "units": 20
                                       }
                                   }
                               },
                               {
                                   "labels":
                                       {
                                           "displayName": "Dish1 - mild",
                                           "description": "Dish1 - a mild spiciness version of our dish!",
                                           "languageCode": "en"
                                       },
                                   "attributes": {
                                       "price": {
                                           "currencyCode": "USD",
                                           "units": 20
                                       }
                                   }
                               }
                           ]
                       }
                   ]
               },
               {
                   "labels": {
                       "displayName": "Desserts",
                       "languageCode": "en"
                   },
                   "items": [
                       {
                           "labels": {
                               "displayName": "Ice Cream",
                               "description": "2 scoops of delicious ice cream!",
                               "languageCode": "en"
                           },
                           "attributes": {
                               "price": {
                                   "currencyCode": "USD",
                                   "units": 20
                               }
                           }
                       }
                   ]
               }
           ]
       }
   ]
}

שיוך תמונות לפריט מזון

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

הערה: אי אפשר להשתמש בתמונות כתמונת שער או כתמונת פרופיל.

כדי לשחזר את התמונות, מתקשרים למספר accounts.locations.media.list. דוגמה לבקשה:

GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/media/

התשובה מכילה את הערך MediaKey של כל תמונה בכרטיס המוצר, כמו בדוגמה הבאה:

{
 "mediaItems": [
   {
     "name": "accounts/{accountId}/locations/{locationId}/media/{mediaKey}",
     "mediaFormat": "PHOTO",
     "locationAssociation": {
       "category": "FOOD_AND_MENU"
     },
 …
}

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