Google Merchant Center

The Google Merchant Center app connects Merchant Center to Sprigr Team with complete Merchant API coverage: one named tool per API method across accounts and sub-accounts, users, business information, homepage, shipping, return policies, regions, programs, services, terms of service, product inputs and processed products, local and regional inventories, promotions, data sources and conversion sources, performance reports, quota, notification subscriptions, order tracking signals, issue resolution, local feeds partnership and reviews. Scheduled imports mirror your product listing status and Merchant Reports into data indexes, where each offer id pairs with the Shopify variant SKU.

Note

Google Merchant Center ships as a marketplace app with one connection per install. An admin connects one Google account with Merchant Center access, and every agent with the app acts through it. A default Merchant Center account is set once for the install.

Prerequisites

• A Google account with access to the Merchant Center account or accounts you want agents to work with.
• Admin or Owner role in your Sprigr Team organisation to install the app.

Installing and connecting

1. Install the app

   Sign in to team.sprigr.com, open Apps in the sidebar, find Google Merchant Center under Available, and install it. See Installing Apps.

2. Connect a Google account

   Open the app’s settings page from Apps > Installed and click Connect Google Merchant Center. Sign in and approve the request. The page then lists the accessible Merchant Center accounts; if exactly one is visible it becomes the default.

3. Set the default account

   If several accounts are accessible, choose the default under Default Merchant Center account, or ask your agent to set it with gmc_set_default_account. Use Refresh accounts after access changes in Merchant Center.

4. Check the connection

   Ask your agent “Is Merchant Center connected, and how many products are listed?” It calls gmc_connection_status and gmc_list_products.

Try asking your agent

“Which products are disapproved right now, and why?”

“How did our Shopping listings perform last week by clicks and conversions, and which offers slipped?”

“Where is our price on the Widget Pro against competitors?”

Imports and data indexes

• Product status. Every 15 minutes the app continues a walk of each configured account’s product listing, completing a full catalogue pass once a day, and mirrors a flattened view (offer id, title, brand, availability, destination status) into the product_status index. Offer id pairs with the Shopify variant SKU.
• Merchant Reports. Every 15 minutes, with a resumable cursor, the app imports the report families: product performance (daily clicks, impressions and conversions per offer, month-sharded), product issues and price competitiveness (daily snapshots), and best sellers (monthly rankings). The first pass backfills 13 months.
• gmc_perf_import_status shows progress per account and family: phase, cursor date, rows imported, quota backoff and any report view Google has not made available to the account. gmc_perf_import_restart re-imports from the start or from a given day; every write is an upsert.

Undo

Reversible writes are journalled so the platform’s undo layer can restore a record’s previous state.

What agents can do

The app exposes 142 tools, one per Merchant API method, prefixed gmc_. At a category level:

• Accounts: list, get, create and configure, update, delete; sub-accounts; users; business info and identity; homepage claim; email preferences; autofeed and automatic improvements; account issues; developer registration.
• Shipping, returns and regions: shipping settings, return policies, regions with batch create, update and delete.
• Programs and services: enable and disable programs; relationships and services; checkout settings; omnichannel settings and inventory verification; Business Profile linking; terms of service.
• Products: list and get processed products, insert, update and delete product inputs, local and regional inventories, promotions, aggregate product statuses.
• Data and conversion sources: list, get, create, update, delete, fetch and file-upload status.
• Reports: gmc_search_reports runs any Merchant Center Query Language report, including price competitiveness and price insights views.
• Operations: quota groups and limits, notification subscriptions, order tracking signals, rendered account and product issues with issue actions.
• Local feeds partnership: inventory, sales, stores and merchant state.
• Reviews: merchant and product reviews.

Deletes are actions the agent takes at your instruction; ask it to describe the change before it runs.

Common use cases

• Disapproval triage. The agent lists disapproved offers with the reason and drafts fixes for the product data.
• Listing performance. A weekly workflow reports clicks, impressions and conversions per offer, joined to Shopify sales by SKU.
• Price benchmarking. Price competitiveness snapshots show where you sit against the market by product.
• Promotions. The agent creates a promotion for a sale period and confirms it is approved.
• Feed operations. “Fetch the primary feed now” triggers a data source fetch after a catalogue change.

Troubleshooting

Not connected Nobody has completed the Connect step, or the connection was revoked. Reconnect from the app’s settings page.

No accessible accounts The connected Google account has no Merchant Center access. Grant it in Merchant Center under Users, then use Refresh accounts.

A report view is unavailable Some Merchant Reports views only exist for accounts enrolled in the matching program. gmc_perf_import_status shows which families are parked for that reason.

Quota errors The Merchant API enforces per-account quotas; the imports back off automatically. gmc_list_quota_groups shows your usage.

Next steps

• Shopify: Where the offer ids come from.
• Google Ads: Shopping campaign spend by offer id.
• Integrations Overview: See all available integrations.