# Merchant API . accounts . homepage

## Instance Methods

Claims a store's homepage. Executing this method requires admin access. If the homepage is already claimed, this will recheck the verification (unless the merchant is exempted from claiming, which also exempts from verification) and return a successful response. If ownership can no longer be verified, it will return an error, but it won't clear the claim. In case of failure, a canonical error message will be returned: * PERMISSION_DENIED: user doesn't have the necessary permissions on this MC account; * FAILED_PRECONDITION: - The account is not a Merchant Center account; - MC account doesn't have a homepage; - claiming failed (in this case the error message will contain more details).

Close httplib2 connections.

Retrieves a store's homepage.

Unclaims a store's homepage. Executing this method requires admin access.

Updates a store's homepage. Executing this method requires admin access.

### Method Details

`claim(name, body=None, x__xgafv=None)`

    Claims a store's homepage. Executing this method requires admin access. If the homepage is already claimed, this will recheck the verification (unless the merchant is exempted from claiming, which also exempts from verification) and return a successful response. If ownership can no longer be verified, it will return an error, but it won't clear the claim. In case of failure, a canonical error message will be returned: * PERMISSION_DENIED: user doesn't have the necessary permissions on this MC account; * FAILED_PRECONDITION: - The account is not a Merchant Center account; - MC account doesn't have a homepage; - claiming failed (in this case the error message will contain more details).

    Args:
      name: string, Required. The name of the homepage to claim. Format: `accounts/{account}/homepage` (required)
      body: object, The request body.
        The object takes the form of:

    { # Request message for the `ClaimHomepage` method.
      "overwrite": True or False, # Optional. 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.
    }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # The `Homepage` message represents a merchant's store homepage within the system. A merchant's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the merchant to unlock features that require a verified website. For more information, see [Understanding online store URL verification](//support.google.com/merchants/answer/176793).
      "claimed": True or False, # Output only. Whether the homepage is claimed. See https://support.google.com/merchants/answer/176793.
      "name": "A String", # Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage`
      "uri": "A String", # Required. The URI (typically a URL) of the store's homepage.
    }

`close()`

    Close httplib2 connections.

`getHomepage(name, x__xgafv=None)`

    Retrieves a store's homepage.

    Args:
      name: string, Required. The name of the homepage to retrieve. Format: `accounts/{account}/homepage` (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # The `Homepage` message represents a merchant's store homepage within the system. A merchant's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the merchant to unlock features that require a verified website. For more information, see [Understanding online store URL verification](//support.google.com/merchants/answer/176793).
      "claimed": True or False, # Output only. Whether the homepage is claimed. See https://support.google.com/merchants/answer/176793.
      "name": "A String", # Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage`
      "uri": "A String", # Required. The URI (typically a URL) of the store's homepage.
    }

`unclaim(name, body=None, x__xgafv=None)`

    Unclaims a store's homepage. Executing this method requires admin access.

    Args:
      name: string, Required. The name of the homepage to unclaim. Format: `accounts/{account}/homepage` (required)
      body: object, The request body.
        The object takes the form of:

    { # Request message for the `UnclaimHomepage` method.
    }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # The `Homepage` message represents a merchant's store homepage within the system. A merchant's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the merchant to unlock features that require a verified website. For more information, see [Understanding online store URL verification](//support.google.com/merchants/answer/176793).
      "claimed": True or False, # Output only. Whether the homepage is claimed. See https://support.google.com/merchants/answer/176793.
      "name": "A String", # Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage`
      "uri": "A String", # Required. The URI (typically a URL) of the store's homepage.
    }

`updateHomepage(name, body=None, updateMask=None, x__xgafv=None)`

    Updates a store's homepage. Executing this method requires admin access.

    Args:
      name: string, Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage` (required)
      body: object, The request body.
        The object takes the form of:

    { # The `Homepage` message represents a merchant's store homepage within the system. A merchant's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the merchant to unlock features that require a verified website. For more information, see [Understanding online store URL verification](//support.google.com/merchants/answer/176793).
      "claimed": True or False, # Output only. Whether the homepage is claimed. See https://support.google.com/merchants/answer/176793.
      "name": "A String", # Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage`
      "uri": "A String", # Required. The URI (typically a URL) of the store's homepage.
    }

      updateMask: string, Optional. List of fields being updated. The following fields are supported (in both `snake_case` and `lowerCamelCase`): - `uri`
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # The `Homepage` message represents a merchant's store homepage within the system. A merchant's homepage is the primary domain where customers interact with their store. The homepage can be claimed and verified as a proof of ownership and allows the merchant to unlock features that require a verified website. For more information, see [Understanding online store URL verification](//support.google.com/merchants/answer/176793).
      "claimed": True or False, # Output only. Whether the homepage is claimed. See https://support.google.com/merchants/answer/176793.
      "name": "A String", # Identifier. The resource name of the store's homepage. Format: `accounts/{account}/homepage`
      "uri": "A String", # Required. The URI (typically a URL) of the store's homepage.
    }