gmc products

Manage Merchant Center products. Every subcommand operates on the account resolved from --account / GMC_ACCOUNT_ID / your profile.

The Merchant API splits products in two: a read-only processed product (list / get, with status and item-level issues) and a writable product input (insert / update / delete). gmc presents both under gmc products.

gmc products list

List processed products for the account.

gmc products list
gmc products list --page-size 50
gmc products list --json   # { "products": [ … ] }

Option	Description
--page-size <n>	Max products per API page

gmc products get <productId>

Fetch one processed product, with its status and any item-level issues. The id is the composite {contentLanguage}~{feedLabel}~{offerId} (as shown by list; legacy-local products use a local~ prefix); the full resource name is also accepted.

gmc products get en~US~SKU1
gmc products get en~US~SKU1 --json

If an identity component contains /, %, or ~, GMC automatically uses Google's unpadded base64url path form. The base64EncodedName returned by Google can also be passed directly.

gmc products insert

Insert (create or replace) a product input from a JSON ProductInput, read from --file or stdin, under a data source.

gmc products insert --data-source 11223344 --file product.json
cat product.json | gmc products insert --data-source 11223344

Option	Description
--data-source <id>	Required. A primary API data source (id or resource name)
--file <path>	Read the ProductInput JSON from this file (else stdin)

{
  "offerId": "SKU1",
  "contentLanguage": "en",
  "feedLabel": "US",
  "productAttributes": {
    "title": "Trail Runner",
    "link": "https://shop.com/p/run01",
    "price": { "amountMicros": "49990000", "currencyCode": "USD" },
    "availability": "in_stock",
    "gtins": ["4006381333931"],
    "videoLinks": ["https://shop.com/videos/run01.mp4"]
  }
}

Read-after-write

Inserting succeeds immediately, but the processed product (get / list) is computed asynchronously and may take a few minutes to appear.

gmc products update <productId>

Patch selected fields on an existing product input without resending the full required product.

gmc products update en~US~SKU1 --data-source 11223344 \
  --file patch.json --update-mask price,availability
cat patch.json | gmc products update en~US~SKU1 --data-source 11223344

Option	Description
--data-source <id>	Required. Primary or supplemental API source containing the input
--file <path>	Partial ProductInput JSON (else stdin)
--update-mask <fields>	Top-level product attributes to update/delete, or custom_attribute.<name>

With no mask, Google updates populated fields. A field named by the mask but absent from the body is deleted. Google does not support * full replacement here; use insert for full replacement.

Current 2026 attributes

The typed API includes plural gtins (singular gtin remains deprecated-compatible), videoLinks, returnPolicyLabel, offer-level returns, handlingCutoffTimes, minimumOrderValues, pickupCost, loyalty shipping labels, and the conversational product fields (questionsAndAnswers, documentLinks, relatedProducts, itemGroupTitle, variantOptions, popularityRank). Files can still carry any other Merchant product attribute as customAttributes.

gmc products delete <productId>

Delete a product input from a data source.

gmc products delete en~US~SKU1 --data-source 11223344

Option	Description
--data-source <id>	Required. The data source (id or resource name) to delete from

Exit codes

2 if the account, --data-source, update mask, or JSON input is missing/invalid · 3 auth · 5 Merchant API.

Data sources

Pass an existing primary API data source via --data-source. To create and manage data sources, see gmc datasources.