Se hai aggiunto menu di cibo alla tua scheda, i clienti conoscono le scelte del menu del tuo ristorante e possono ottenere informazioni aggiuntive sui piatti del menu.
Per aggiornare i menu di un'inserzione, 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'FoodMenus corrente della scheda. Modifica l'oggetto FoodMenus in base alle esigenze e chiama
accounts.locations.updateFoodMenus.
Per ulteriori informazioni, consulta
Caricare o sostituire i menu di cibo.
Puoi utilizzare l'API di Google My Business per aggiornare i seguenti campi:
| Campi | |
|---|---|
| Nome | Obbligatorio Nome dell'alimento, ad esempio |
| Prezzo | Obbligatorio Prezzo del prodotto alimentare. |
| Valuta del prezzo | Obbligatorio La valuta del prezzo dell'articolo alimentare, ad esempio |
| Descrizione elemento | Facoltativo Breve descrizione dell'alimento. |
| Sezioni del menu | Facoltativo Gruppi logici di articoli alimentari, ad esempio |
| Alimentazione | Facoltativo (consigliato) Informazioni nutrizionali, ad esempio |
| Numero di utenti da raggiungere | Facoltativo Il numero di persone a cui può essere servito l'alimento. |
| Quantità | Facoltativo Quantità dell'alimento. Ad esempio,
|
| Metodi di preparazione | Facoltativo Metodi specifici con cui l'alimento può essere preparato. |
| Cucine | Facoltativo (consigliato) La cucina specifica del prodotto alimentare. |
| Piccante | Facoltativo Il livello di piccantezza dell'alimento, ad esempio |
| Allergeni | Facoltativo (consigliato) Gli allergeni alimentari presenti nell'alimento, ad esempio |
| Preferenze alimentari | Facoltativo (consigliato) Limitazioni alimentari dell'alimento, ad esempio |
| Opzioni | Facoltativo Il tipo di opzione alimentare, ad esempio |
| Foto dell'alimento | Facoltativo Foto dell'alimento specifico. |
Caricare o sostituire i menu di cibo
Non tutte le sedi sono idonee al caricamento dei menu di cibo.
Per determinare l'idoneità di una sede, chiama
locations.get
per controllare la
Metadata.
Se canHaveFoodMenus è impostato su true, puoi caricare i menu di cibo.
Se la tua località è idonea, effettua una chiamata PATCH al numero
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 le foto a un alimento
Per associare una foto a un articolo alimentare, devi prima caricarla nella sede del 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 il 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 il mediaKey della foto e forniscilo nell'oggetto FoodMenuItemAttributes. Puoi fornire più mediaKeys.
Per ulteriori informazioni, consulta
Caricare o sostituire i menu di cibo.