rocket
Meet
Merchant API
- the official successor to Content API for Shopping.
update
Get the latest
on new Merchant API features, bug fixes, and updates.
add_alert
Note: Content API for Shopping will be sunset on August 18, 2026.
Method: accounts.claimwebsite
Stay organized with collections
Save and categorize content based on your preferences.
Claims the website of a Merchant Center sub-account. Merchant accounts with approved third-party CSSs aren't required to claim a website.
HTTP request
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite
Path parameters
| Parameters |
merchantId |
string
The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.
|
accountId |
string
The ID of the account whose website is claimed.
|
Query parameters
| Parameters |
overwrite |
boolean
Only available to selected merchants, for example multi-client accounts (MCAs) and their sub-accounts. When set to True, this option removes any existing claim on the requested website and replaces it with a claim from the account that makes the request.
|
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
| JSON representation |
{
"kind": string
} |
| Fields |
kind |
string
Identifies what kind of resource this is. Value: the fixed string "content#accountsClaimWebsiteResponse".
|
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/content
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-25 UTC.
[null,null,["Last updated 2025-02-25 UTC."],[[["\u003cp\u003eClaims a website for a Merchant Center sub-account, unless it's managed by an approved third-party CSS.\u003c/p\u003e\n"],["\u003cp\u003eRequires a \u003ccode\u003ePOST\u003c/code\u003e request to the specified endpoint with \u003ccode\u003emerchantId\u003c/code\u003e and \u003ccode\u003eaccountId\u003c/code\u003e as path parameters.\u003c/p\u003e\n"],["\u003cp\u003eOptionally, uses the \u003ccode\u003eoverwrite\u003c/code\u003e query parameter to replace existing website claims.\u003c/p\u003e\n"],["\u003cp\u003eAn empty request body is necessary for this operation.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful execution, the response includes a confirmation with the kind "\u003ccode\u003econtent#accountsClaimWebsiteResponse\u003c/code\u003e".\u003c/p\u003e\n"]]],["This document details the process for claiming a website for a Merchant Center sub-account via an API. The core action involves sending a `POST` HTTP request to a specified URL, including the `merchantId` and `accountId` as path parameters. The `overwrite` query parameter, if set to `true`, allows replacing existing website claims. The request body should be empty. A successful response includes a JSON body with a `kind` field indicating the resource type: \"`content#accountsClaimWebsiteResponse`\". The API requires specific OAuth authorization scopes.\n"],null,["# Method: accounts.claimwebsite\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.AccountsClaimWebsiteResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nClaims the website of a Merchant Center sub-account. Merchant accounts with approved third-party CSSs aren't required to claim a website.\n\n### HTTP request\n\n`POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite`\n\n### Path parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `merchantId` | `string` The ID of the managing account. If this parameter is not the same as [accountId](#accountId), then this account must be a multi-client account and `accountId` must be the ID of a sub-account of this account. |\n| `accountId` | `string` The ID of the account whose website is claimed. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `overwrite` | `boolean` Only available to selected merchants, for example multi-client accounts (MCAs) and their sub-accounts. When set to `True`, this option removes any existing claim on the requested website and replaces it with a claim from the account that makes the request. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------|\n| ``` { \"kind\": string } ``` |\n\n| Fields ||\n|--------|----------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string \"`content#accountsClaimWebsiteResponse`\". |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]