عندما يكون لديك قوائم الطعام إلى بطاقة بياناتك، وسيعرف العملاء خيارات قائمة الطعام في مطعمك، الحصول على معلومات إضافية حول عناصر القائمة.
لتعديل "قوائم الطعام" في بيانات المنتجات، يُرجى الاتصال أولاً
accounts.locations.getFoodMenus
في ما يلي مثال على الطلب:
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/foodMenus
يحتوي الردّ على تمثيل JSON للقائمة الحالية
FoodMenus يمكنك تعديل الكائن FoodMenus حسب الحاجة والاتصال.
accounts.locations.updateFoodMenus
لمزيد من المعلومات، يُرجى مراجعة
تحميل قوائم الطعام أو استبدالها
يمكنك استخدام واجهة برمجة تطبيقات "نشاطي التجاري على Google" لتعديل الحقول التالية:
| الحقول | |
|---|---|
| الاسم | مطلوب تمثّل هذه السمة اسم السلعة الغذائية، مثل |
| السعر | مطلوب سعر صنف الطعام |
| عملة السعر | مطلوب عملة سعر السلعة الغذائية، مثل |
| وصف العنصر | اختياريّ وصف موجز لصنف الطعام. |
| أقسام القائمة | اختياريّ المجموعات المنطقية للمواد الغذائية، مثل |
| تغذية | اختيارية (يُنصح بها) المعلومات الغذائية، مثل |
| عدد الأشخاص المطلوب الخدمة | اختياريّ عدد الأشخاص الذين يمكن تقديم صنف الطعام لهم. |
| حجم الكسر | اختياريّ كمية السلعة من الطعام على سبيل المثال:
|
| طرق التحضير | اختياريّ الطرق المحددة التي يمكن إعداد صنف الطعام بها. |
| مطابخ | اختيارية (يُنصح بها) تمثّل هذه السمة المطبخ المحدّد للطبق. |
| توابل | اختياريّ توابل السلعة الغذائية، مثل |
| مسببات الحساسية | اختيارية (يُنصح بها) مسببات الحساسية الغذائية في المواد الغذائية، مثل |
| النظام الغذائي | اختيارية (يُنصح بها) القيود الغذائية للمواد الغذائية، مثل |
| الخيارات | اختياريّ نوع خيار الطعام، مثل |
| صورة صنف من الطعام | اختياريّ صورة لصنف الطعام المحدّد |
تحميل قوائم الطعام أو استبدالها
ليست كل المواقع الجغرافية مؤهَّلة لتحميل قوائم الطعام.
لتحديد أهلية موقع جغرافي، اتصل
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
}
}
}
]
}
]
}
]
}
ربط الصور بصنف من الطعام
لربط صورة بصنف من الطعام، عليك أولاً تحميل الصورة إلى الموقع الجغرافي في "الملف التجاري على Google"
لاسترداد الصور، اتصل
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.
لمزيد من المعلومات، يُرجى مراجعة
تحميل قوائم الطعام أو استبدالها