عندما تضيف قوائم طعام إلى بطاقة بياناتك، سيعرف العملاء خيارات قائمة الطعام في مطعمك وسيتمكّنون من الحصول على معلومات إضافية حول أصناف الطعام.
لتعديل قوائم الطعام الخاصة بنشاط تجاري، عليك أولاً إجراء طلب
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، تكون مؤهلاً لتحميل قوائم الطعام.
إذا كان موقعك الجغرافي مؤهَّلاً، اتّصِل بالرقم PATCHaccounts.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.
لمزيد من المعلومات، راجِع مقالة تحميل قوائم الطعام أو استبدالها.