Cập nhật thực đơn

Khi bạn có Thực đơn món ăn thêm vào danh sách, khách hàng biết các lựa chọn trong thực đơn của nhà hàng và họ có thể xem thêm thông tin về các món trong trình đơn.

Để cập nhật các Thực đơn món ăn của một trang thông tin, trước tiên hãy gọi accounts.locations.getFoodMenus. Sau đây là một yêu cầu mẫu:

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

Phản hồi này chứa bản trình bày JSON hiện tại của trang thông tin FoodMenus. Sửa đổi đối tượng FoodMenus nếu cần và gọi accounts.locations.updateFoodMenus. Để biết thêm thông tin, hãy xem Tải lên hoặc thay thế thực đơn món ăn.

Bạn có thể sử dụng API Google Doanh nghiệp của tôi để cập nhật các trường sau:

Trường
Tên

Bắt buộc

Tên của món ăn, chẳng hạn như Hamburger.

Giá

Bắt buộc

Giá của món ăn.

Đơn vị tiền tệ của giá

Bắt buộc

Đơn vị tiền tệ của giá thực phẩm, chẳng hạn như U.S. dollar.

Mô tả mặt hàng

Không bắt buộc

Nội dung mô tả ngắn gọn về món ăn.

Các nhóm món ăn trong thực đơn

Không bắt buộc

Các nhóm mặt hàng thực phẩm hợp lý, chẳng hạn như Breakfast hoặc Hamburger-Fries combo.

Dinh dưỡng

Không bắt buộc (nên dùng)

Thông tin dinh dưỡng, chẳng hạn như Total Fat=3g.

Số người sẽ phục vụ

Không bắt buộc

Số người mà mặt hàng thực phẩm có thể phục vụ.

Kích thước phần

Không bắt buộc

Số lượng của mặt hàng thực phẩm. Ví dụ: 8-piece of nuggets.

Phương pháp chuẩn bị

Không bắt buộc

Các phương pháp cụ thể để chế biến món ăn.

Món ăn

Không bắt buộc (nên dùng)

Món ăn đặc trưng của món ăn.

Độ nhạy

Không bắt buộc

Độ nhạy của thực phẩm, chẳng hạn như none, mild, mediumhot.

Chất gây dị ứng

Không bắt buộc (nên dùng)

Các chất gây dị ứng thực phẩm trong thực phẩm, chẳng hạn như dairy, egg, fish, peanut shellfish, soy, tree nutwheat.

Chế độ ăn uống

Không bắt buộc (nên dùng)

Hạn chế trong chế độ ăn uống của món ăn, chẳng hạn như halal, kosher, organic, vegan vegetariangluten free.

Tùy chọn

Không bắt buộc

Loại thực phẩm, chẳng hạn như chicken Pad Thái so với veggie Pad Thái.

Ảnh món ăn

Không bắt buộc

Ảnh của mặt hàng thức ăn cụ thể.

Tải lên hoặc thay thế thực đơn món ăn

Không phải địa điểm nào cũng đủ điều kiện để tải Thực đơn món ăn lên.

Để xác định xem một vị trí có đủ điều kiện hay không, hãy gọi locations.get để kiểm tra Metadata. Nếu đặt canHaveFoodMenus thành true thì bạn sẽ đủ điều kiện tải lên Thực đơn món ăn.

Nếu vị trí của bạn đủ điều kiện, hãy thực hiện lệnh gọi PATCH để accounts.locations.updateFoodMenus.

Sau đây là một yêu cầu mẫu bao gồm tất cả các trường không bắt buộc:

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
                               }
                           }
                       }
                   ]
               }
           ]
       }
   ]
}

Liên kết ảnh với mặt hàng đồ ăn

Để liên kết ảnh với một món ăn, trước tiên, bạn phải tải ảnh lên Vị trí trên Trang doanh nghiệp.

Để truy xuất ảnh, hãy gọi accounts.locations.media.list. Sau đây là một yêu cầu mẫu:

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

Phản hồi chứa MediaKey cho mỗi hình ảnh trên trang thông tin, như minh hoạ trong ví dụ sau:

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

Để liên kết ảnh với món ăn, hãy lấy mediaKey của ảnh và cung cấp nó trong đối tượng FoodMenuItemAttributes. Bạn có thể cung cấp nhiều mediaKeys. Để biết thêm thông tin, hãy xem Tải lên hoặc thay thế thực đơn món ăn.