> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Google Shopping with OAuth 2.0 – StackOne Hub

> Link a Google Shopping account in the StackOne Hub using OAuth 2.0. End-user guide to authorize the integration and start using Google Shopping actions.

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

<section data-guide-section data-guide-scopes="">
  <h2>Find your Merchant Center ID</h2>

  <p>The <strong>Merchant Center ID</strong> (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.</p>

  <Steps>
    <Step title="Locate the ID">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to <a href="https://merchants.google.com/" target="_blank" rel="noopener noreferrer">Merchant Center</a> and select the target account. The numeric ID appears either:</p>

        <ul>
          <li>In the top-right account switcher — click the account name and copy the value shown under <strong>Merchant Center ID</strong>.</li>
          <li>In the browser URL — `https://merchants.google.com/mc/...?a={accountId}` (the `a=` query parameter).</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Verify your storefront homepage</h2>

  <p>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.</p>

  <Steps>
    <Step title="Set and verify the storefront">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In Merchant Center, open <strong>Settings</strong> > <strong>Business info</strong> > <strong>Details</strong> tab and find the <strong>Your online store</strong> card on the right. Click <strong>Edit online store</strong>, 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 <strong>Verified</strong> and <strong>Claimed</strong> badges before you proceed. See the <a href="https://support.google.com/merchants/answer/11586344" target="_blank" rel="noopener noreferrer">Merchant Center homepage verification guide</a> for details.</p>
      </div>
    </Step>
  </Steps>
</section>

<div data-whitelabel-hide>
  <h2>Linking the Account from the Hub</h2>

  <Steps>
    <Step title="Navigate to the Hub">
      Use one of the three <a href="/guides/accounts-section#linking-accounts">Linking Account Methods</a> to access the Hub.
    </Step>

    <Step title="Fill out the fields">
      Fill out the following fields using details from your provider:

      <ul>
        <li><strong>Merchant Center ID</strong></li>
      </ul>
    </Step>

    <Step title="Connect">
      <ul>
        <li>Click <strong>Connect</strong></li>
        <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
        <li>Once authorization is successful, you will see a confirmation popup</li>
      </ul>
    </Step>
  </Steps>

  <p>If the account linking is successful, you will see the newly linked account in your <a href="/guides/accounts-section">Accounts</a> page.</p>
</div>