Skip to main content

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 + optional location_id, as in location info.
  • Types: APPOINTMENT, ONLINE_APPOINTMENT, DINING_RESERVATION, FOOD_ORDERING, FOOD_DELIVERY, FOOD_TAKEOUT, SHOP_ONLINE, SOLOPRENEUR_APPOINTMENT.
Availability

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).

  • 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.

  • 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.

  • 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.

  • Method: DELETE
  • Body: {"user": "...", "link": "locations/111/placeActionLinks/abc", "confirm": true}

Errors​

StatuscodeMeaning
400invalid_place_action_type / invalid_uri / invalid_linkA parameter is not valid.
400link_not_editablePartner link: only is_disabled can change.
400confirmation_requiredDeleting needs "confirm": true.
400invalid_jsonThe body is not a valid JSON object.
400google_validation_errorGoogle rejected it (e.g. duplicate link).
404link_not_foundThe link does not exist.
502google_result_unknownGoogle did not confirm a new link: list the links before creating it again.
503google_api_not_enabledNot available yet.