Aggiornare i menu di cibo

Quando hai aggiunto Menu di cibo alla tua scheda, i clienti conoscono le scelte del menu del tuo ristorante e possono ottenere informazioni aggiuntive sulle voci del menu.

Per aggiornare i menu di un'attività, chiama prima accounts.locations.getFoodMenus. Di seguito è riportato un esempio di richiesta:

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

La risposta contiene una rappresentazione JSON dell'attuale FoodMenus della scheda. Modifica l'oggetto FoodMenus in base alle esigenze e chiama accounts.locations.updateFoodMenus. Per maggiori informazioni, vedi Caricare o sostituire i menu dei ristoranti.

Puoi utilizzare l'API Google My Business per aggiornare i seguenti campi:

Campi
Nome

Obbligatorio

Il nome dell'alimento, ad esempio Hamburger.

Prezzo

Obbligatorio

Il prezzo dell'alimento.

Valuta del prezzo

Obbligatorio

Valuta del prezzo dell'articolo alimentare, ad esempio U.S. dollar.

Descrizione elemento

Facoltativo

Breve descrizione dell'alimento.

Sezioni del menu

Facoltativo

Gruppi logici di alimenti, ad esempio Breakfast o Hamburger-Fries combo.

Alimentazione

Facoltativo (consigliato)

Informazioni nutrizionali, ad esempio Total Fat=3g.

Numero di persone da servire

Facoltativo

Il numero di persone a cui può essere servito l'alimento.

Porzione

Facoltativo

Quantità dell'alimento. Ad esempio, 8-piece of nuggets.

Metodi di preparazione

Facoltativo

Metodi specifici di preparazione dell'alimento.

Cucine

Facoltativo (consigliato)

La cucina specifica dell'alimento.

Piccantezza

Facoltativo

Piccantezza dell'alimento, ad esempio none, mild, medium e hot.

Allergene

Facoltativo (consigliato)

Allergeni alimentari nell'alimento, ad esempio dairy, egg, fish, peanut, shellfish, soy, tree nut e wheat.

Preferenze alimentari

Facoltativo (consigliato)

Limitazione alimentare dell'alimento, ad esempio halal, kosher, organic, vegan, vegetarian, gluten free e dairy free.

Opzioni

Facoltativo

Il tipo di opzione di cibo, ad esempio chicken Pad Thai rispetto a veggie Pad Thai.

Foto dell'alimento

Facoltativo

Foto dell'alimento specifico.

Caricare o sostituire i menu del ristorante

Non tutte le sedi sono idonee per il caricamento dei menu del cibo.

Per determinare l'idoneità di una località, chiama locations.get per controllare Metadata. Se canHaveFoodMenus è impostato su true, puoi caricare i menu dei ristoranti.

Se la tua località è idonea, effettua una chiamata al numero PATCH accounts.locations.updateFoodMenus.

Di seguito è riportato un esempio di richiesta che include tutti i campi facoltativi:

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

Associare foto a un alimento

Per associare una foto a un piatto, devi prima caricare la foto nella sede del tuo profilo dell'attività.

Per recuperare le foto, chiama accounts.locations.media.list. Di seguito è riportato un esempio di richiesta:

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

La risposta contiene MediaKey per ogni immagine della scheda, come mostrato nell'esempio seguente:

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

Per associare una foto a un alimento, recupera l'mediaKey della foto e fornisci nell'oggetto FoodMenuItemAttributes. Puoi fornire più mediaKeys. Per maggiori informazioni, vedi Caricare o sostituire i menu dei ristoranti.