Skip to main content

Google Business Menus and Services

  • Authentication: API Key — Authorization: Apikey <YOUR_API_KEY>
  • Location: user + optional location_id, as in location info.
Google replaces the whole list

Menus and services cannot be edited item by item: what you send replaces the current list, and anything you leave out is removed. Read the current list first with GET, change it, and send it back complete with "confirm": true.

Food menus​

  • GET /api/uploadposts/google-business/food-menus?user=X[&location_id=][&read_mask=menus]
  • PUT /api/uploadposts/google-business/food-menus
NameTypeRequiredDescription
menusarrayYesComplete list of menus in Google's FoodMenu format (labels, cuisines, sections with items, prices, dietary restrictions, allergens...). "menus": null removes every menu; an empty list [] changes nothing.
confirmbooleanYestrue (the list is replaced).
dry_runbooleanNoChecks eligibility and the request without sending it.

Dish photos go in each item's attributes.mediaKeys (up to 200 photos in total), using the mediaKey of photos already in the location's gallery. Only locations Google allows to have menus (restaurants and similar) can use it; others answer 400 food_menus_not_supported.

Services​

  • GET /api/uploadposts/google-business/services?user=X[&location_id=] — returns service_items and can_modify_service_list.
  • PUT /api/uploadposts/google-business/services
NameTypeRequiredDescription
service_itemsarrayYesComplete list. Each item has exactly one of structuredServiceItem (serviceTypeId from category details with view=FULL, optional description up to 300 characters) or freeFormServiceItem (category, label.displayName, optional label.description); optional price (currencyCode, units, nanos). "service_items": null removes every service; an empty list [] changes nothing.
confirmbooleanYestrue (the list is replaced). Not needed with dry_run.
dry_runbooleanNoGoogle validates the list without applying it.
apistringNov1 (default, the format above) or v4 (Google's older service list format; dry_run then only checks on our side).
{
"user": "barberia-sol",
"confirm": true,
"service_items": [
{ "structuredServiceItem": { "serviceTypeId": "job_type_id:haircut", "description": "Corte clásico" },
"price": { "currencyCode": "EUR", "units": "15" } },
{ "freeFormServiceItem": { "category": "categories/gcid:barber_shop", "label": { "displayName": "Afeitado a navaja" } } }
]
}

The answer includes edit_status (experimental) like location info. Locations that cannot list services answer 400 services_not_supported.

Errors​

StatuscodeMeaning
400invalid_menus / too_many_menu_photos / invalid_fieldThe list is not valid.
400confirmation_requiredReplacing needs "confirm": true.
400invalid_jsonThe body is not a valid JSON object.
400food_menus_not_supported / services_not_supportedGoogle does not allow it on this location.
400account_requiredPass location_id as accounts/{account}/locations/{location} or reconnect Google Business.
429location_edit_rate_limitedToo many edits on this location in a minute.