Reference
Google Merchant Center tools
Read feed health, disapprovals, account issues, and Shopping reports on every plan. The separate guided customLabel4 pilot requires operator enrollment for one selected account and one registered product. Tool visibility does not enable writes.
On this page
Before you begin
Connect the relevant Google Merchant Center account through Accounts, then connect your AI assistant. Confirm the target account and date range before querying data or making changes.
This is the generated catalog. The tools shown in your AI assistant depend on your connected accounts, active workspace, role, write permissions, enabled features and the client's supported tool surface. A listed tool is not a promise that it is enabled in every workspace. See accounts, workspace access and troubleshooting.
Available tools
6 tools.
| Tool | Access | Purpose |
|---|---|---|
merchant_get_report | Read | Run a validated Merchant Center report preset. |
merchant_list_accounts | Read | List Google Merchant Center accounts you can access. |
merchant_prepare_writes | Write | Preview one explicitly selected product in an operator-enrolled own API source. |
merchant_query | Read | Read Merchant Center entities polymorphically. |
merchant_revert_product | Write | Remove only our owned single-label input using a confirmed revert preview. |
merchant_update_product | Write | Apply the exact latest customLabel4 preview after the user confirms its token. |
Write tools can change account settings, campaigns or workspace content. Confirm the target and proposed changes before running them.
Label writes require a guided session and separate operator enrollment. Each apply and revert needs your own preview-token confirmation. Read the merchant label pilot for steps and stop conditions.
Using these tools
Start by asking which accounts are connected. Then request a read-only report or inspection for one account before making a change.
API capabilities
Available fields and combinations depend on the resource, account and campaign type. Adapt the examples to your selected account.
Metrics
| Category | Fields |
|---|---|
| Product Performance (free listings) | clicks, impressions, click_through_rate, conversions, conversion_value |
| Product Status | aggregated_reporting_context_status, item_issues, click_potential, click_potential_rank |
Dimensions
| Category | Fields |
|---|---|
| Product | offer_id, id, title, brand |
Query examples
List Merchant Center Accounts
List top-level accounts plus direct sub-accounts of advanced accounts
Tool: merchant_list_accounts.
{}
Product Statuses and Disapproval Reasons
Check which products are approved, pending, or disapproved and why
Tool: merchant_query.
{
"account_id": "123456789",
"entity_type": "product_statuses",
"page_size": 50
}
Disapproval Impact Report
Disapproved products ranked by Merchant Center's click potential estimate, with item-level issue details
Tool: merchant_get_report.
{
"account_id": "123456789",
"preset": "disapproval_impact"
}
Technical reference
API endpoint: merchantapi.googleapis.com. Status: stable.
Google Merchant API v1 (the successor of Content API for Shopping). Sub-APIs used: accounts/v1, products/v1, datasources/v1, reports/v1.
Rate limits
| Limit | Scope | Notes |
|---|---|---|
| Per method group, per day and per minute | Merchant API | Quotas adjust automatically; there are no fixed published QPS numbers |
| 1,000 rows | Ad Superpowers cap per report call | Integration default page size is 100; paginate with page_token. The Merchant API itself allows larger pages |
| 100 rows | account issues maximum per page | accounts.issues.list caps pageSize at 100 |
Limitations and notes
- General access is for reads. Only an operator-enrolled pilot can change customLabel4 on one registered product through its existing, exclusively managed supplemental source
- Every apply and revert needs its own preview and your explicit token confirmation. Pending means accepted, not processed; use label_operation reads to check processing
- No batch updates, general product corrections, prices, stock, titles, primary-source changes, or feed-rule management
- When authorization expires, the pilot needs guided Google reauthorization with the same workspace, connection owner, and Google identity. Automatic account-token renewal does not renew the authorization used by this label flow
- UNKNOWN stops further changes, including revert. Do not retry or delete manually; contact support. Revert deletes only our own single-label input and leaves the source and link in place
- Reports are limited to three validated presets (product_performance, disapproval_impact, clicks_without_conversions); there is no raw query mode
- Conversions and conversion value only cover free (organic Shopping) traffic; paid conversions live in Google Ads
- No cost metric exists in the Merchant API; join with Google Ads for spend impact
- Account discovery lists one level of sub-accounts and is cached for 24 hours
