Speisekarte aktualisieren

Wenn Sie Ihrem Eintrag Speisekarten hinzufügen, können sich Gäste über das Angebot in Ihrem Restaurant und weitere Details informieren.

Die Speisekarten eines Eintrags lassen sich aktualisieren, indem Sie zuerst accounts.locations.getFoodMenus aufrufen. Hier eine Beispielanfrage:

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

Die Antwort enthält eine JSON-Darstellung des aktuellen FoodMenus-Objekts des Eintrags. Ändern Sie das FoodMenus-Objekt nach Bedarf und rufen Sie accounts.locations.updateFoodMenus auf. Weitere Informationen finden Sie unter Speisekarten hochladen oder ersetzen.

Mit der Google My Business API können Sie die folgenden Felder aktualisieren:

Felder
Name

Pflichtfeld

Name der Speise, z. B. Hamburger

Preis

Pflichtfeld

Preis der Speise

Währung des Preises

Pflichtfeld

Währung des Preises der Speise, z. B. U.S. dollar

Artikelbeschreibung

Optional

Kurze Beschreibung der Speise

Abschnitte der Speisekarte

Optional

Logische Gruppen von Speisen, zum Beispiel Breakfast oder Hamburger-Fries combo.

Nährwert

Optional (empfohlen)

Angaben zum Nährwert wie Total Fat=3g.

Anzahl der zu bedienenden Personen

Optional

Anzahl der Personen, für die die Speise ausreicht

Portionsgröße

Optional

Menge der Speise, z. B. 8-piece of nuggets

Zubereitungsmethoden

Optional

Spezielle Methoden der Zubereitung der Speise

Internationale und regionale Küche

Optional (empfohlen)

Spezielle Zubereitung der Speise

Schärfe

Optional

Schärfe der Speise, z. B. none, mild, medium und hot

Allergene

Optional (empfohlen)

Lebensmittelallergene in der Speise, z. B. dairy, egg, fish, peanut, shellfish, soy, tree nut und wheat

Spezielle Ernährung

Optional (empfohlen)

Ernährungseinschränkungen für die Speise, z. B. halal, kosher, organic, vegan, vegetarian und gluten free

Optionen

Optional

Basis der Speise, z. B. chicken Pad Thai oder veggie Pad Thai

Foto der Speise

Optional

Foto der jeweiligen Speise

Speisekarten hochladen oder ersetzen

Nicht alle Standorte sind zum Hochladen von Speisekarten berechtigt.

Um die Berechtigung eines Standorts zu prüfen, rufen Sie locations.get auf und sehen Sie sich Metadata an. Wenn für canHaveFoodMenus der Wert true festgelegt ist, können Sie Speisekarten hochladen.

Sofern Ihr Standort berechtigt ist, führen Sie einen PATCH-Aufruf an accounts.locations.updateFoodMenus aus.

Die folgende Beispielanfrage enthält alle optionalen Felder:

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

Fotos mit Speisen verknüpfen

Wenn Sie ein Foto mit einer Speise verknüpfen möchten, müssen Sie es zuerst in Ihren Google Unternehmensprofil-Standort hochladen.

Rufen Sie accounts.locations.media.list auf, um die Fotos abzurufen. Hier eine Beispielanfrage:

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

Die Antwort enthält das jeweilige MediaKey-Objekt für die einzelnen Bilder im Eintrag, wie das folgende Beispiel zeigt:

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

Wenn Sie ein Foto mit einer Speise verknüpfen möchten, rufen Sie das mediaKey-Objekt des Fotos auf und versehen Sie es mit einem FoodMenuItemAttributes-Objekt. Sie können mehrere mediaKeys-Objekte angeben. Weitere Informationen finden Sie unter Speisekarten hochladen oder ersetzen.