Google Business Menus and Services
- Authentication: API Key —
Authorization: Apikey <YOUR_API_KEY> - Location:
user+ optionallocation_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
| Name | Type | Required | Description |
|---|---|---|---|
menus | array | Yes | Complete 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. |
confirm | boolean | Yes | true (the list is replaced). |
dry_run | boolean | No | Checks 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=]— returnsservice_itemsandcan_modify_service_list.PUT /api/uploadposts/google-business/services
| Name | Type | Required | Description |
|---|---|---|---|
service_items | array | Yes | Complete 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. |
confirm | boolean | Yes | true (the list is replaced). Not needed with dry_run. |
dry_run | boolean | No | Google validates the list without applying it. |
api | string | No | v1 (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
| Status | code | Meaning |
|---|---|---|
| 400 | invalid_menus / too_many_menu_photos / invalid_field | The list is not valid. |
| 400 | confirmation_required | Replacing needs "confirm": true. |
| 400 | invalid_json | The body is not a valid JSON object. |
| 400 | food_menus_not_supported / services_not_supported | Google does not allow it on this location. |
| 400 | account_required | Pass location_id as accounts/{account}/locations/{location} or reconnect Google Business. |
| 429 | location_edit_rate_limited | Too many edits on this location in a minute. |