Aggiorna i menu di cucina

Dopo aver aggiunto Menu alimentari alla tua scheda, i clienti conoscono le scelte del menu del ristorante e possono ricevere ulteriori informazioni sulle portate del menù.

Per aggiornare i menu Alimenti di una scheda, chiama innanzitutto accounts.locations.getFoodMenus. Di seguito è riportata una richiesta di esempio:

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 menù alimentari.

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

Campi
Nome

Obbligatorio

Nome dell'alimento, ad esempio Hamburger.

Prezzo

Obbligatorio

Il prezzo dell'alimento.

Valuta del prezzo

Obbligatorio

Valuta del prezzo dell'alimento, 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

Numero di persone che l'alimento può essere servito.

Dimensione della porzione

Facoltativo

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

Metodi di preparazione

Facoltativo

Metodi specifici in cui è possibile preparare l'alimento.

Cucine

Facoltativo (consigliato)

La cucina specifica dell'alimento.

Piccantezza

Facoltativo

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

Allergeni

Facoltativo (consigliato)

Allergeni alimentari nel cibo, ad esempio dairy, egg, fish, peanut, shellfish, soy, tree nut e wheat.

Preferenze alimentari

Facoltativo (consigliato)

Restrizione alimentare di un alimento, come halal, kosher, organic, vegan, vegetarian e gluten free.

Opzioni

Facoltativo

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

Foto dell'alimento

Facoltativo

Foto dell'alimento specifico.

Caricare o sostituire i menù alimentari

Non tutte le sedi sono idonee al caricamento di menu alimentari.

Per determinare l'idoneità di una sede, chiama il numero locations.get per consultare il Metadata. Se il criterio canHaveFoodMenus è impostato su true, puoi caricare menu culinari.

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

Di seguito è riportata una richiesta di esempio 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 alimento, devi prima caricare la foto nella sede del profilo della tua attività.

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

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

La risposta contiene il valore MediaKey per ogni immagine nella 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, ottieni il mediaKey della foto e forniscilo nell'oggetto FoodMenuItemAttributes. Puoi fornire più mediaKeys. Per maggiori informazioni, vedi Caricare o sostituire i menù alimentari.