Google Merchant Routing Reference

App name: google-merchant Base URL proxied: merchantapi.googleapis.com

API Path Pattern

/google-merchant/{sub-api}/{version}/accounts/{accountId}/{resource}

The Merchant API uses sub-APIs: products, accounts, datasources, reports, promotions, inventories, notifications, conversions, lfp

Common Endpoints

List Products

GET /google-merchant/products/v1/accounts/{accountId}/products

Get Product

GET /google-merchant/products/v1/accounts/{accountId}/products/{productId}

Product ID format: contentLanguage~feedLabel~offerId (e.g., en~US~sku123)

Insert Product Input

POST /google-merchant/products/v1/accounts/{accountId}/productInputs:insert?dataSource=accounts/{accountId}/dataSources/{dataSourceId}
Content-Type: application/json

{
  "offerId": "sku123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "attributes": {
    "title": "Product Title",
    "link": "https://example.com/product",
    "imageLink": "https://example.com/image.jpg",
    "availability": "in_stock",
    "price": {"amountMicros": "19990000", "currencyCode": "USD"}
  }
}

Delete Product Input

DELETE /google-merchant/products/v1/accounts/{accountId}/productInputs/{productId}?dataSource=accounts/{accountId}/dataSources/{dataSourceId}

List Data Sources

GET /google-merchant/datasources/v1/accounts/{accountId}/dataSources

Search Reports

POST /google-merchant/reports/v1/accounts/{accountId}/reports:search
Content-Type: application/json

{
  "query": "SELECT offer_id, title, clicks FROM product_performance_view WHERE date BETWEEN '2026-01-01' AND '2026-01-31'"
}

List Promotions

GET /google-merchant/promotions/v1/accounts/{accountId}/promotions

Get Account

GET /google-merchant/accounts/v1/accounts/{accountId}

List Local Inventories

GET /google-merchant/inventories/v1/accounts/{accountId}/products/{productId}/localInventories

Notes

Authentication is automatic - the router injects the OAuth token
Account ID is your Merchant Center numeric ID (visible in MC URL)
Product IDs use format contentLanguage~feedLabel~offerId
Monetary values use micros (divide by 1,000,000)
Products can only be inserted in data sources of type API
Uses token-based pagination with pageSize and pageToken

2.7 KiB Raw Blame History