Files

Krilly 57dd294675 AI Newsletter Digest improvements: fixed QP soft line break decoding, URL extraction, and content cleaning

2026-03-04 13:29:22 +00:00

5.0 KiB

Raw Permalink Blame History

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

Important: The v1 API requires one-time developer registration per Merchant Center account. Complete the registration steps below before using any endpoints.

Developer Registration

Before using v1 endpoints, you must complete a one-time registration:

Step 1: Get Your Account ID

Option A: Try fetching via API first

Try listing accounts using the v1beta endpoint. If this works, you can get your account ID automatically:

GET /google-merchant/accounts/v1beta/accounts

Response (if successful):

{
  "accounts": [
    {"accountId": "123456789", "accountName": "My Store"}
  ]
}

Option B: From Merchant Center UI (if Option A fails)

If the v1beta endpoint is unavailable or returns an error:

Log in to Google Merchant Center
Your account ID is in the URL: https://merchants.google.com/mc/overview?a=YOUR_ACCOUNT_ID

For example, if your URL is https://merchants.google.com/mc/overview?a=123456789, your account ID is 123456789.

Step 2: Register for API Access

POST /google-merchant/accounts/v1/accounts/{accountId}/developerRegistration:registerGcp
Content-Type: application/json

{
  "developerEmail": "your-email@example.com"
}

Replace {accountId} with your account ID from Step 1, and use the email associated with your Google account.

Response:

{
  "name": "accounts/123456789/developerRegistration",
  "gcpIds": ["..."]
}

Step 3: Verify Registration

After registration, test that v1 endpoints work:

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

Note: Registration only needs to be done once per Merchant Center account. After successful registration, all v1 endpoints will work for that account.

Common Endpoints

List Accounts

GET /google-merchant/accounts/v1/accounts

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",
  "productAttributes": {
    "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 id, offer_id, title FROM product_view LIMIT 10"
}

Note: The product_view table requires the id field in SELECT clause.

List Promotions

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

Note: Requires Promotions program enrollment.

Get Account

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

List Regional Inventories

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

List Local Inventories

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

Note: Local inventories only work for products with LOCAL channel.

Notes

Developer registration required - Complete registration before using v1 endpoints
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 with input: "API" type
Uses token-based pagination with pageSize and pageToken
Promotions require account enrollment in Promotions program
Local inventories only work for LOCAL channel products

5.0 KiB Raw Permalink Blame History