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