وقتی منوهای غذا را به فهرست خود اضافه می‌کنید، مشتریان از انتخاب‌های منوی رستوران شما اطلاع دارند و می‌توانند اطلاعات بیشتری درباره موارد منو دریافت کنند.
برای به‌روزرسانی منوهای غذایی فهرست، ابتدا با accounts.locations.getFoodMenus تماس بگیرید. در زیر یک نمونه درخواست است:
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/foodMenus
پاسخ حاوی نمایش JSON از FoodMenus فعلی فهرست است. شی FoodMenus را در صورت نیاز تغییر دهید و با accounts.locations.updateFoodMenus تماس بگیرید. برای اطلاعات بیشتر، به آپلود یا جایگزینی منوهای غذا مراجعه کنید.
می‌توانید از Google My Business API برای به‌روزرسانی فیلدهای زیر استفاده کنید:
| فیلدها | |
|---|---|
| نام | مورد نیاز نام ماده غذایی، مانند |
| قیمت | مورد نیاز قیمت ماده غذایی. |
| قیمت ارز | مورد نیاز واحد پولی قیمت ماده غذایی، مانند |
| توضیحات مورد | اختیاری توضیحات مختصری در مورد ماده غذایی |
| بخش های منو | اختیاری گروه های منطقی مواد غذایی، مانند ترکیب |
| تغذیه | اختیاری (توصیه می شود) اطلاعات تغذیه ای، مانند |
| تعداد افرادی که باید خدمت کنند | اختیاری تعداد افرادی که ماده غذایی می تواند سرو کند. |
| اندازه بخش | اختیاری مقدار ماده غذایی. مثلا |
| روش های آماده سازی | اختیاری روش های خاصی که می توان ماده غذایی را با آن تهیه کرد. |
| غذاهای | اختیاری (توصیه می شود) آشپزی خاص ماده غذایی. |
| تندی | اختیاری تندی بودن ماده غذایی مانند |
| آلرژن | اختیاری (توصیه می شود) آلرژن های غذایی موجود در ماده غذایی مانند |
| رژیمی | اختیاری (توصیه می شود) محدودیت غذایی در مورد مواد غذایی مانند |
| گزینه ها | اختیاری نوع گزینه غذایی، مانند |
| عکس اقلام غذایی | اختیاری عکس ماده غذایی خاص |
منوهای غذا را آپلود یا جایگزین کنید
همه مکان‌ها واجد شرایط آپلود منوهای غذا نیستند.
برای تعیین واجد شرایط بودن یک مکان، با 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 ارائه کنید. برای اطلاعات بیشتر، به آپلود یا جایگزینی منوهای غذا مراجعه کنید.