Manage your homepage settings

Your homepage is the primary domain where customers interact with your store. You must claim and verify your homepage as a proof of ownership. Claiming your homepage lets you unlock features that require a verified website. For more information, see Understanding online store URL verification.

To claim, unclaim, update, and retrieve a homepage, you can use the following methods:

Claim your homepage

To claim your homepage, use the accounts.homepage.claim method.

Here's a sample request:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/homepage:claim

Replace {ACCOUNT_ID} with the unique identifier of your Merchant Center account.

Here's a sample response from a successful call:

{
  "name": "accounts/{ACCOUNT_ID}/homepage",
  "uri": "{URI}",
  "claimed": true
}

Retrieve your homepage

To retrieve your homepage, use the accounts.homepage.getHomepage method.

Here's a sample request:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/homepage

Here's a sample response from a successful call:

{
  "name": "accounts/{ACCOUNT_ID}/homepage",
  "uri": "{URI}",
  "claimed": true
}

Unclaim your homepage

To unclaim your homepage, use the accounts.homepage.unclaim method.

Here's a sample request:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/homepage:unclaim

Here's a sample response from a successful call:

{
  "name": "accounts/{ACCOUNT_ID}/homepage",
  "uri": "{URI}",
  "claimed": false
}

Update your homepage

To update your homepage, use the accounts.homepage.updateHomepage method.

Here's a sample request:

PATCH https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/homepage

Here's a sample response from a successful call:

{
  "name": "accounts/{ACCOUNT_ID}/homepage",
  "uri": "{URI}"
}