Skip to main content
On first connect the connector automatically registers the Google Cloud project with your Merchant Center account. The OAuth user must be an Admin of the account and the account must have a verified storefront homepage, otherwise the connection test will fail.

​
Find your Merchant Center ID

The Merchant Center ID (sometimes called “Merchant Center Account ID”) is the numeric identifier of the Merchant Center account this connection will operate against. Every API call the connector makes is scoped to this account.

1

Locate the ID

Sign in to Merchant Center and select the target account. The numeric ID appears either:

  • In the top-right account switcher — click the account name and copy the value shown under Merchant Center ID.
  • In the browser URL — https://merchants.google.com/mc/...?a={accountId} (the a= query parameter).

​
Verify your storefront homepage

Google requires the Merchant Center account to have a verified storefront before the connector’s one-time developerRegistration:registerGcp bootstrap can succeed. A missing or unverified storefront causes a 400 HOMEPAGE_NOT_VERIFIED on first connect.

1

Set and verify the storefront

In Merchant Center, open Settings > Business info > Details tab and find the Your online store card on the right. Click Edit online store, enter your storefront URL, and complete one of Google’s verification methods (HTML tag, file upload, Google Analytics, or Google Tag Manager). The card should display both Verified and Claimed badges before you proceed. See the Merchant Center homepage verification guide for details.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Merchant Center ID
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.