Audit your existing Content API integration: list all methods called (products.insert, products.update, productstatuses.list, etc.) and map each to its Merchant API v1 equivalent using the compatibility overview at developers.google.com/merchant/api/guides/compatibility/overview.
Create a new OAuth 2.0 credential (or reuse the existing one) and update your scope to include https://www.googleapis.com/auth/content — the Merchant API uses the same OAuth scope as Content API.
Update the base URL from https://shoppingcontent.googleapis.com/content/v2.1/merchantId/ to https://merchantapi.googleapis.com/products/v1/accounts/merchantId/ and adjust resource naming (products become 'accounts/{id}/products/{productId}' in Merchant API).
Replace products.insert/update with products.productInputs.insert using the dataSource ID; retrieve your dataSource ID with datasources.list — each feed (primary, supplemental) is a separate dataSource.
Test by inserting a sample product and calling products.get to verify attributes are mapped correctly; use the Merchant API's productStatuses resource to confirm approval status.
Run both APIs in parallel (dual-write) until you confirm parity, then cut over before August 18, 2026 — Content API returns errors after that date.
Known gotchas
Feed labels do not automatically transfer from Content API to Merchant API; you must re-create them as dataSources and re-link any associated Google Ads Performance Max or Shopping campaigns, otherwise campaigns stop serving.
The Merchant API uses a different resource identifier scheme — the numeric offer ID is replaced by a structured productId of the form 'channel:contentLanguage:feedLabel:offerId'; update any ID storage in your database accordingly.
The v1beta Merchant API was shut down on February 28, 2026 — if you were on beta, you must be on v1 GA now; all new integrations should target v1 directly.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp