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