Google Business Booking and Ordering Links
The buttons customers see on the listing in Google Search and Maps: book a table, order food, delivery, takeout, appointments, online shop.
- Authentication: API Key —
Authorization: Apikey <YOUR_API_KEY> - Location:
user+ optionallocation_id, as in location info. - Types:
APPOINTMENT,ONLINE_APPOINTMENT,DINING_RESERVATION,FOOD_ORDERING,FOOD_DELIVERY,FOOD_TAKEOUT,SHOP_ONLINE,SOLOPRENEUR_APPOINTMENT.
If this feature is not available yet, the API answers 503 google_api_not_enabled. Try
again later.
Which types can the location use?
GET /api/uploadposts/google-business/place-actions/types?user=X[&location_id=][&language_code=es]
Or for a country: ?region_code=ES (cached 24 h). Returns types
(placeActionType, displayName).
List and read links
GET /api/uploadposts/google-business/place-actions?user=X[&type=SHOP_ONLINE][&page_size=][&page_token=]GET /api/uploadposts/google-business/place-actions/get?user=X&link=locations/111/placeActionLinks/abc
Each link has name, placeActionType, uri, isPreferred, isDisabled,
providerType (MERCHANT or AGGREGATOR_3P) and isEditable.
Create a link
- Method:
POST - Endpoint:
/api/uploadposts/google-business/place-actions - Body:
{"user": "...", "type": "DINING_RESERVATION", "uri": "https://book.example/sol", "is_preferred": true}
Google allows one link per URL and type on each location, and one preferred link per type
(marking a new one as preferred removes the flag from the previous one). dry_run: true
validates and returns what would be sent, without calling Google.
Edit or switch off a link
- Method:
PATCH - Endpoint:
/api/uploadposts/google-business/place-actions - Body:
{"user": "...", "link": "locations/111/placeActionLinks/abc", "uri": "...", "type": "...", "is_preferred": false, "is_disabled": true}
Only the fields you send change. Links added by a booking partner (isEditable: false)
can only be switched on or off with is_disabled; anything else answers
400 link_not_editable.
Delete a link
- Method:
DELETE - Body:
{"user": "...", "link": "locations/111/placeActionLinks/abc", "confirm": true}
Errors
| Status | code | Meaning |
|---|---|---|
| 400 | invalid_place_action_type / invalid_uri / invalid_link | A parameter is not valid. |
| 400 | link_not_editable | Partner link: only is_disabled can change. |
| 400 | confirmation_required | Deleting needs "confirm": true. |
| 400 | invalid_json | The body is not a valid JSON object. |
| 400 | google_validation_error | Google rejected it (e.g. duplicate link). |
| 404 | link_not_found | The link does not exist. |
| 502 | google_result_unknown | Google did not confirm a new link: list the links before creating it again. |
| 503 | google_api_not_enabled | Not available yet. |