Skip to content
Merchant Center

Recheck a Merchant Center connection

Verifies again that the property's Merchant Center account is reachable and still linked to its Google Ads account, and marks the connection active when it is.

POST /properties/{propertyId}/merchant-center/connection/recheck

Scope setup · Access Changes data · Operation id merchant_center.recheck_connection

Try it

productmetrics runs after productmetrics login; curl needs PM_TOKEN (see Authentication). Set $PROPERTY_ID first.

productmetrics merchant-center recheck-connection \
  --property-id $PROPERTY_ID \
  --json

Response

API response (200):

{
  "data": {
    "propertyId": "8c1f4d2e-7a3b-4c5d-9e6f-0a1b2c3d4e5f",
    "status": "active",
    "lastCheckedAt": "2026-11-02T09:30:00.000Z"
  },
  "request_id": "req_01JHTN4DAJ1T25KQ9FHCG5KYN7"
}

CLI output: productmetrics merchant-center recheck-connection --json prints { "ok": true, "data": …, "request_id": "…" } with the same data.

Before you call

Call it after fixing access or when the connection shows status error. Needs company admin.

Path parameters

NameTypeDescription
propertyIdstringThe property id, from productmetrics whoami or properties.list (property_id).

Errors

A failure answers with its HTTP status and { error: { code, message, details? }, request_id }. Branch on code (stable, lower_snake); show message to the person. The CLI prints the same error with "ok": false.

{
  "error": {
    "code": "insufficient_scope",
    "message": "This operation needs the setup scope; connect again and allow it.",
    "details": {
      "required_scope": "setup"
    }
  },
  "request_id": "req_01JT7K0KAQ80T4R2R5DYZ1PWXN"
}
StatusCodeWhen
400invalid_requestA path, query or body value does not match this page. details.issues lists each location, path and message.
401invalid_tokenThe token is missing, expired or revoked: sign in again (productmetrics login). The WWW-Authenticate header says why.
403insufficient_scopeThe token lacks the setup scope (details.required_scope): sign in again and allow it.
404not_foundAn id in the path does not exist, or the signed-in person cannot open it.
429rate_limitedMore than 600 requests a minute for this person: wait the Retry-After seconds (60) and retry.

All Merchant Center operations