Merchant API . accounts . homepage

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.
}

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

Returns:
  An object of the form:

    { # A store's homepage.
  "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:

    { # A store's homepage.
  "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:

    { # A store's homepage.
  "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:

{ # A store's homepage.
  "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, Required. List of fields being updated.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A store's homepage.
  "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.
}