Google My Business Place Actions API
Browse all Google APIs✓ Official Vendor SpecMarketingContent Managementoauth26 EndpointsREST
For Agents
Add and manage action links (book, order, reserve, appointments) on Google Business Profile listings. Use to drive direct conversions from Search and Maps panels.
Use for: Add a Reserve with Google booking link to a restaurant location, List all action links on a Business Profile location, Update the order ahead URL for a coffee shop location, Delete a deprecated appointments link
Not supported: Does not process bookings, take payments, or edit non-action listing fields — use for managing Google Business action link URLs only.
The My Business Place Actions API manages action links — book, order, reserve, menu, appointments — that appear on Google Business Profile listings in Google Search and Maps. It exposes placeActionLinks per location and a placeActionTypeMetadata listing that explains which action types each country and category supports. Use it to drive bookings and orders directly from a Business Profile panel without sending users to a search results page.
Install Jentic One Beta
Connect the My Business Place Actions API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the My Business Place Actions API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with My Business Place Actions API.
Create a place action link such as a booking or ordering URL on a location
List all action links currently configured on a location
Update an action link's URL or preferred status
Delete an obsolete or migrated action link
Look up which place action types are supported in a region and category
Mark a specific action link as the preferred entry point for its action type
Use Cases
Patterns agents use My Business Place Actions API for, with concrete tasks.
★ Booking Provider Migration
When a brand switches third-party booking providers, every Business Profile location's reserve link must change in lock-step. The placeActionLinks resource supports list, patch, and delete so a workflow can find the old provider's link, replace its URL with the new provider, and mark it preferred — keeping inbound conversion working through the migration window.
List /v1/{parent}/placeActionLinks with placeActionType=RESERVATION, PATCH the URL to the new provider, set isPreferred=true, then DELETE the old link.
Multi-Location Order-Ahead Roll-Out
Quick-service brands launching online ordering need an order link on every storefront's Business Profile. The Place Actions API accepts a per-location create with placeActionType=ONLINE_APPOINTMENT or FOOD_ORDERING, so a fan-out across the location list adds the new conversion point in minutes rather than per-location UI clicks.
Iterate over locations under accounts/{account} and POST /v1/{parent}/placeActionLinks with placeActionType=FOOD_ORDERING_DELIVERY and the order URL.
Region-Aware Action Coverage
Place action types are not uniformly supported across countries and categories. The placeActionTypeMetadata endpoint returns which types are valid given a regionCode and category, letting a workflow filter out unsupported actions before attempting to create them and avoiding 400 errors on PATCH.
GET /v1/placeActionTypeMetadata with regionCode and languageCode, build the supported set, and only create links whose placeActionType is in that set.
AI Agent Conversion Optimiser
An AI agent reachable through Jentic compares conversion data per location, tests new action link URLs, and rotates the preferred booking partner. Jentic isolates OAuth credentials and exposes the right Place Actions operation per intent so the agent never reads the discovery document or holds Google client secrets.
Search Jentic for 'add a booking link to a Google Business listing', load placeActionLinks.create, and execute with placeActionType=RESERVATION and the test URL.
Key Endpoints
6 endpoints — the my business place actions api manages action links — book, order, reserve, menu, appointments — that appear on google business profile listings in google search and maps.
METHOD
PATH
DESCRIPTION
GET
/v1/placeActionTypeMetadata
List supported action types and required fields
GET
/v1/{parent}/placeActionLinks
List action links on a location
POST
/v1/{parent}/placeActionLinks
Create an action link on a location
PATCH
/v1/{name}
Update an action link
DELETE
/v1/{name}
Delete an action link
GET
/v1/placeActionTypeMetadata
List supported action types and required fields
GET
/v1/{parent}/placeActionLinks
List action links on a location
POST
/v1/{parent}/placeActionLinks
Create an action link on a location
PATCH
/v1/{name}
Update an action link
DELETE
/v1/{name}
Delete an action link
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
OAuth 2.0 refresh tokens are stored encrypted in the Jentic vault. The agent receives scoped, short-lived access tokens — Google client secrets never enter the agent context.
Intent-based discovery
Agents search Jentic by intent (e.g. 'add a booking link to a Google Business listing') and Jentic returns the matching Place Actions operation with its input schema.
Time to first call
Direct integration: 1-2 days for OAuth, quota approval, and per-region action filtering. Through Jentic: under an hour — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using My Business Place Actions API through Jentic.
What authentication does the My Business Place Actions API use?
OAuth 2.0 with the https://www.googleapis.com/auth/business.manage scope. The user must be an admin on the target Business Profile account. Through Jentic the OAuth refresh token is held in MAXsystem and the agent only receives scoped short-lived access tokens.
Can I add a Reserve with Google link via this API?
Yes. POST /v1/{parent}/placeActionLinks with placeActionType=RESERVATION and the URL of your booking provider's deep link. Mark isPreferred=true if it should be the default reservation link on the listing.
What are the rate limits for the My Business Place Actions API?
Default quota is 0 QPM until Business Profile API access is granted. Once approved Google sets per-minute and per-day quotas; bulk action link sweeps should be paced and back off on 429 responses.
How do I update an action link through Jentic?
Search Jentic for 'update Google Business action link', load placeActionLinks.patch, and execute it with the new URL and updateMask=uri. Jentic handles the OAuth refresh in the background.
Why does creating an action link return INVALID_ARGUMENT for some categories?
Place action types are restricted by region and category. Call GET /v1/placeActionTypeMetadata with the location's regionCode and languageCode to see which types are valid for the location before creating the link.
GET STARTED