Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request.
Deletes a Merchant Center sub-account.
Retrieves a Merchant Center account.
Creates a Merchant Center sub-account.
list(merchantId, pageToken=None, maxResults=None)
Lists the sub-accounts in your Merchant Center account.
list_next(previous_request, previous_response)
Retrieves the next page of results.
patch(merchantId, accountId, body)
Updates a Merchant Center account. This method supports patch semantics.
update(merchantId, accountId, body)
Updates a Merchant Center account.
custombatch(body)
Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request.
Args:
body: object, The request body. (required)
The object takes the form of:
{
"entries": [
{ # A batch entry encoding a single non-batch request to the accounts service of the Content API for Shopping.
"batchId": 42, # An entry ID, unique within the batch request.
"method": "A String", # The method (get, insert, update, or delete).
"account": { # The account to create or update. Only defined if the method is insert or update.
"reviewsUrl": "A String", # URL for individual seller reviews, i.e., reviews for each child account.
"kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account".
"name": "A String", # Display name for the account.
"adultContent": True or False, # Indicates whether the merchant sells adult content.
"id": "A String", # Merchant Center account ID.
"websiteUrl": "A String", # The merchant's website.
"sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account.
"adwordsLinks": [ # List of linked AdWords accounts.
{
"status": "A String", # Status of the link between this Merchant Center account and the AdWords account.
"adwordsId": "A String", # Customer ID of the AdWords account.
},
],
"users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
{
"admin": True or False, # Whether user is an admin.
"emailAddress": "A String", # User's email address.
},
],
},
"merchantId": "A String", # The ID of the managing account.
"accountId": "A String", # The ID of the account to get or delete. Only defined if the method is get or delete.
},
],
}
Returns:
An object of the form:
{
"kind": "content#accountsCustomBatchResponse", # Identifies what kind of resource this is. Value: the fixed string "content#accountsCustomBatchResponse".
"entries": [
{ # A batch entry encoding a single non-batch response from the accounts service of the Content API for Shopping.
"batchId": 42, # The ID of the request entry this entry responds to.
"account": { # The retrieved, created, or updated account. Not defined if the method was delete.
"reviewsUrl": "A String", # URL for individual seller reviews, i.e., reviews for each child account.
"kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account".
"name": "A String", # Display name for the account.
"adultContent": True or False, # Indicates whether the merchant sells adult content.
"id": "A String", # Merchant Center account ID.
"websiteUrl": "A String", # The merchant's website.
"sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account.
"adwordsLinks": [ # List of linked AdWords accounts.
{
"status": "A String", # Status of the link between this Merchant Center account and the AdWords account.
"adwordsId": "A String", # Customer ID of the AdWords account.
},
],
"users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
{
"admin": True or False, # Whether user is an admin.
"emailAddress": "A String", # User's email address.
},
],
},
"errors": { # A list of errors returned by a failed batch entry. # A list of errors defined if and only if the request failed.
"message": "A String", # The message of the first error in errors.
"code": 42, # The HTTP status of the first error in errors.
"errors": [ # A list of errors.
{ # An error returned by the API.
"reason": "A String", # The error code.
"domain": "A String", # The domain of the error.
"message": "A String", # A description of the error.
},
],
},
"kind": "content#accountsCustomBatchResponseEntry", # Identifies what kind of resource this is. Value: the fixed string "content#accountsCustomBatchResponseEntry".
},
],
}
delete(merchantId, accountId)
Deletes a Merchant Center sub-account. Args: merchantId: string, The ID of the managing account. (required) accountId: string, The ID of the account. (required)
get(merchantId, accountId)
Retrieves a Merchant Center account.
Args:
merchantId: string, The ID of the managing account. (required)
accountId: string, The ID of the account. (required)
Returns:
An object of the form:
{
"reviewsUrl": "A String", # URL for individual seller reviews, i.e., reviews for each child account.
"kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account".
"name": "A String", # Display name for the account.
"adultContent": True or False, # Indicates whether the merchant sells adult content.
"id": "A String", # Merchant Center account ID.
"websiteUrl": "A String", # The merchant's website.
"sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account.
"adwordsLinks": [ # List of linked AdWords accounts.
{
"status": "A String", # Status of the link between this Merchant Center account and the AdWords account.
"adwordsId": "A String", # Customer ID of the AdWords account.
},
],
"users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
{
"admin": True or False, # Whether user is an admin.
"emailAddress": "A String", # User's email address.
},
],
}
insert(merchantId, body)
Creates a Merchant Center sub-account.
Args:
merchantId: string, The ID of the managing account. (required)
body: object, The request body. (required)
The object takes the form of:
{
"reviewsUrl": "A String", # URL for individual seller reviews, i.e., reviews for each child account.
"kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account".
"name": "A String", # Display name for the account.
"adultContent": True or False, # Indicates whether the merchant sells adult content.
"id": "A String", # Merchant Center account ID.
"websiteUrl": "A String", # The merchant's website.
"sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account.
"adwordsLinks": [ # List of linked AdWords accounts.
{
"status": "A String", # Status of the link between this Merchant Center account and the AdWords account.
"adwordsId": "A String", # Customer ID of the AdWords account.
},
],
"users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
{
"admin": True or False, # Whether user is an admin.
"emailAddress": "A String", # User's email address.
},
],
}
Returns:
An object of the form:
{
"reviewsUrl": "A String", # URL for individual seller reviews, i.e., reviews for each child account.
"kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account".
"name": "A String", # Display name for the account.
"adultContent": True or False, # Indicates whether the merchant sells adult content.
"id": "A String", # Merchant Center account ID.
"websiteUrl": "A String", # The merchant's website.
"sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account.
"adwordsLinks": [ # List of linked AdWords accounts.
{
"status": "A String", # Status of the link between this Merchant Center account and the AdWords account.
"adwordsId": "A String", # Customer ID of the AdWords account.
},
],
"users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
{
"admin": True or False, # Whether user is an admin.
"emailAddress": "A String", # User's email address.
},
],
}
list(merchantId, pageToken=None, maxResults=None)
Lists the sub-accounts in your Merchant Center account.
Args:
merchantId: string, The ID of the managing account. (required)
pageToken: string, The token returned by the previous request.
maxResults: integer, The maximum number of accounts to return in the response, used for paging.
Returns:
An object of the form:
{
"nextPageToken": "A String",
"kind": "content#accountsListResponse", # Identifies what kind of resource this is. Value: the fixed string "content#accountsListResponse".
"resources": [
{
"reviewsUrl": "A String", # URL for individual seller reviews, i.e., reviews for each child account.
"kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account".
"name": "A String", # Display name for the account.
"adultContent": True or False, # Indicates whether the merchant sells adult content.
"id": "A String", # Merchant Center account ID.
"websiteUrl": "A String", # The merchant's website.
"sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account.
"adwordsLinks": [ # List of linked AdWords accounts.
{
"status": "A String", # Status of the link between this Merchant Center account and the AdWords account.
"adwordsId": "A String", # Customer ID of the AdWords account.
},
],
"users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
{
"admin": True or False, # Whether user is an admin.
"emailAddress": "A String", # User's email address.
},
],
},
],
}
list_next(previous_request, previous_response)
Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.
patch(merchantId, accountId, body)
Updates a Merchant Center account. This method supports patch semantics.
Args:
merchantId: string, The ID of the managing account. (required)
accountId: string, The ID of the account. (required)
body: object, The request body. (required)
The object takes the form of:
{
"reviewsUrl": "A String", # URL for individual seller reviews, i.e., reviews for each child account.
"kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account".
"name": "A String", # Display name for the account.
"adultContent": True or False, # Indicates whether the merchant sells adult content.
"id": "A String", # Merchant Center account ID.
"websiteUrl": "A String", # The merchant's website.
"sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account.
"adwordsLinks": [ # List of linked AdWords accounts.
{
"status": "A String", # Status of the link between this Merchant Center account and the AdWords account.
"adwordsId": "A String", # Customer ID of the AdWords account.
},
],
"users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
{
"admin": True or False, # Whether user is an admin.
"emailAddress": "A String", # User's email address.
},
],
}
Returns:
An object of the form:
{
"reviewsUrl": "A String", # URL for individual seller reviews, i.e., reviews for each child account.
"kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account".
"name": "A String", # Display name for the account.
"adultContent": True or False, # Indicates whether the merchant sells adult content.
"id": "A String", # Merchant Center account ID.
"websiteUrl": "A String", # The merchant's website.
"sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account.
"adwordsLinks": [ # List of linked AdWords accounts.
{
"status": "A String", # Status of the link between this Merchant Center account and the AdWords account.
"adwordsId": "A String", # Customer ID of the AdWords account.
},
],
"users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
{
"admin": True or False, # Whether user is an admin.
"emailAddress": "A String", # User's email address.
},
],
}
update(merchantId, accountId, body)
Updates a Merchant Center account.
Args:
merchantId: string, The ID of the managing account. (required)
accountId: string, The ID of the account. (required)
body: object, The request body. (required)
The object takes the form of:
{
"reviewsUrl": "A String", # URL for individual seller reviews, i.e., reviews for each child account.
"kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account".
"name": "A String", # Display name for the account.
"adultContent": True or False, # Indicates whether the merchant sells adult content.
"id": "A String", # Merchant Center account ID.
"websiteUrl": "A String", # The merchant's website.
"sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account.
"adwordsLinks": [ # List of linked AdWords accounts.
{
"status": "A String", # Status of the link between this Merchant Center account and the AdWords account.
"adwordsId": "A String", # Customer ID of the AdWords account.
},
],
"users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
{
"admin": True or False, # Whether user is an admin.
"emailAddress": "A String", # User's email address.
},
],
}
Returns:
An object of the form:
{
"reviewsUrl": "A String", # URL for individual seller reviews, i.e., reviews for each child account.
"kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account".
"name": "A String", # Display name for the account.
"adultContent": True or False, # Indicates whether the merchant sells adult content.
"id": "A String", # Merchant Center account ID.
"websiteUrl": "A String", # The merchant's website.
"sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account.
"adwordsLinks": [ # List of linked AdWords accounts.
{
"status": "A String", # Status of the link between this Merchant Center account and the AdWords account.
"adwordsId": "A String", # Customer ID of the AdWords account.
},
],
"users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
{
"admin": True or False, # Whether user is an admin.
"emailAddress": "A String", # User's email address.
},
],
}