create_google_price_extension
Add a price-list shown beneath a Google Ads ad — 3-8 tiles, each with a plan/product name, a short description, a USD amount, and a billing unit.
Writes extensions
Creates or changes something in the account. Put it behind whatever review your agent uses.
What it does
Add a price-list shown beneath a Google Ads ad — 3-8 tiles, each with a plan/product name, a short description, a USD amount, and a billing unit. Standard play for SaaS pricing tiers, subscription plans, course catalogs, service menus, or hotel night rates.
ALSO KNOWN AS: price extension, pricing, price list, pricing tiers, plan pricing, subscription pricing, price tiles, rate card, fare list
KEYWORDS: price, pricing, price list, plan, plans, tier, tiers, subscription, monthly, yearly, hourly, daily, fare, rate, cost, dollar, $, USD, google ads, extension
WHEN TO USE:
- "Show our pricing tiers under our Google Ads"
- "Add a price extension with Basic / Pro / Scale plans"
- "Register monthly subscription prices for the campaign"
- "Create a rate card extension starting from $9.99"
WHEN NOT TO USE:
- Single time-bound discount (Black Friday 20% off, promo code) → use create_google_promotion_extension
- Non-priced offerings list (just names, no amounts) → use create_google_structured_snippet_extension
- Same price list for Microsoft Ads / Bing → use create_microsoft_price_extension
INPUTS:
- price_qualifier: prefix shown before each price. UNSPECIFIED (no prefix) | FROM ("From $X") | UP_TO ("Up to $X") | AVERAGE ("Avg $X").
- price_offerings: 3-8 tiles. Each tile:
- url: landing page for that tier (non-blank, ≤2000 chars).
- header: tier name (1-25 chars). E.g. "Basic", "Pro", "Scale".
- description: short tagline (1-25 chars). E.g. "Starter plan".
- amount: USD number (max 999999999.99, two decimals).
- unit: billing cadence. UNSPECIFIED | PER_HOUR | PER_DAY | PER_WEEK | PER_MONTH | PER_YEAR | PER_NIGHT.
EXAMPLE:
create_google_price_extension(
price_qualifier="FROM",
price_offerings=[
{"url": "https://example.com/basic", "header": "Basic",
"description": "Starter plan", "amount": 9.99, "unit": "PER_MONTH"},
{"url": "https://example.com/pro", "header": "Pro",
"description": "Growing teams", "amount": 29.00, "unit": "PER_MONTH"},
{"url": "https://example.com/scale", "header": "Scale",
"description": "Enterprise", "amount": 99.00, "unit": "PER_MONTH"},
],
)Arguments
| Argument | Type | Notes | |
|---|---|---|---|
price_qualifier |
string | required | Price qualifier shown before the price. one of: UNSPECIFIED, FROM, UP_TO, AVERAGE |
price_offerings |
array | required | 3-8 price offerings. |
Request
Request template, not a complete runnable example. Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.
curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
-H "Authorization: $METADATA_PAT" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_google_price_extension","arguments":{"price_qualifier":"UNSPECIFIED","price_offerings":[]}}}'Response
No recorded response. This tool writes to the account, so it is never executed to build these docs.
The request is an illustrative template. Fill required fields and check the current schema before calling it. No response is fabricated.
Related
Other extensions tools: