Plan a Merchant Center product change
merchant_plan_product_patchPlan attribute changes, such as title, description, link, availability, or price, for one Merchant Center product before applying them.
Instructions
PLAN (nothing is written): change some attributes of one product of the client's Merchant Center account, with an explicit update mask (an attribute listed without a value is refused: Google would delete it). Title and description are low risk, link and availability medium, price high and financial (needs a human approval; capped by write.merchant.max_daily_budget_micros, max_increase_pct and cap_currency). Only API data sources. Apply with google_apply after the user agreed; changes show after up to 30 minutes; rollback_plan restores the previous values. Product insert, delete and inventories are deliberately not offered.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| client_id | No | Client id from clients_list. Required when several clients are registered; empty uses the only client | |
| account_id | No | Merchant Center account id of the client (empty: the configured one) | |
| product_id | Yes | Product id contentLanguage~feedLabel~offerId, as merchant_products returns it (e.g. en~FR~SKU123) | |
| update_mask | Yes | Attributes to change, each also given in product_attributes: title, description, link, availability, price | |
| data_source_id | No | Numeric id of the API data source to patch (empty: the product's primary data source) | |
| product_attributes | Yes | New values, e.g. {"title": "...", "availability": "OUT_OF_STOCK", "price": {"amount_micros": 12990000, "currency_code": "EUR"}} |