Retrieves multiple Merchant Center account statuses in a single request.
get(merchantId, accountId, destinations=None)
Retrieves the status of a Merchant Center account. No itemLevelIssues are returned for multi-client accounts.
list(merchantId, pageToken=None, maxResults=None, destinations=None)
Lists the statuses of the sub-accounts in your Merchant Center account.
list_next(previous_request, previous_response)
Retrieves the next page of results.
custombatch(body)
Retrieves multiple Merchant Center account statuses in a single request.
Args:
body: object, The request body. (required)
The object takes the form of:
{
"entries": [ # The request entries to be processed in the batch.
{ # A batch entry encoding a single non-batch accountstatuses request.
"batchId": 42, # An entry ID, unique within the batch request.
"method": "A String", # The method (get).
"destinations": [ # If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.
"A String",
],
"merchantId": "A String", # The ID of the managing account.
"accountId": "A String", # The ID of the (sub-)account whose status to get.
},
],
}
Returns:
An object of the form:
{
"kind": "content#accountstatusesCustomBatchResponse", # Identifies what kind of resource this is. Value: the fixed string "content#accountstatusesCustomBatchResponse".
"entries": [ # The result of the execution of the batch requests.
{ # A batch entry encoding a single non-batch accountstatuses response.
"batchId": 42, # The ID of the request entry this entry responds to.
"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.
},
],
},
"accountStatus": { # The status of an account, i.e., information about its products, which is computed offline and not returned immediately at insertion time. # The requested account status. Defined if and only if the request was successful.
"kind": "content#accountStatus", # Identifies what kind of resource this is. Value: the fixed string "content#accountStatus".
"websiteClaimed": True or False, # Whether the account's website is claimed or not.
"accountLevelIssues": [ # A list of account level issues.
{
"documentation": "A String", # The URL of a web page to help resolving this issue.
"severity": "A String", # Severity of the issue.
"title": "A String", # Short description of the issue.
"country": "A String", # Country for which this issue is reported.
"destination": "A String", # The destination the issue applies to.
"detail": "A String", # Additional details about the issue.
"id": "A String", # Issue identifier.
},
],
"products": [ # List of product-related data by channel, destination, and country. Data in this field may be delayed by up to 30 minutes.
{
"country": "A String", # The country the data applies to.
"itemLevelIssues": [ # List of item-level issues.
{
"code": "A String", # The error code of the issue.
"description": "A String", # A short issue description in English.
"documentation": "A String", # The URL of a web page to help with resolving this issue.
"attributeName": "A String", # The attribute's name, if the issue is caused by a single attribute.
"detail": "A String", # A detailed issue description in English.
"numItems": "A String", # Number of items with this issue.
"servability": "A String", # How this issue affects serving of the offer.
"resolution": "A String", # Whether the issue can be resolved by the merchant.
},
],
"destination": "A String", # The destination the data applies to.
"channel": "A String", # The channel the data applies to.
"statistics": { # Aggregated product statistics.
"active": "A String", # Number of active offers.
"expiring": "A String", # Number of expiring offers.
"disapproved": "A String", # Number of disapproved offers.
"pending": "A String", # Number of pending offers.
},
},
],
"dataQualityIssues": [ # DEPRECATED - never populated.
{
"displayedValue": "A String",
"severity": "A String",
"lastChecked": "A String",
"country": "A String",
"destination": "A String",
"detail": "A String",
"submittedValue": "A String",
"numItems": 42,
"location": "A String",
"id": "A String",
"exampleItems": [
{
"itemId": "A String",
"submittedValue": "A String",
"link": "A String",
"valueOnLandingPage": "A String",
"title": "A String",
},
],
},
],
"accountId": "A String", # The ID of the account for which the status is reported.
},
},
],
}
get(merchantId, accountId, destinations=None)
Retrieves the status of a Merchant Center account. No itemLevelIssues are returned for multi-client accounts.
Args:
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. (required)
accountId: string, The ID of the account. (required)
destinations: string, If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination. (repeated)
Returns:
An object of the form:
{ # The status of an account, i.e., information about its products, which is computed offline and not returned immediately at insertion time.
"kind": "content#accountStatus", # Identifies what kind of resource this is. Value: the fixed string "content#accountStatus".
"websiteClaimed": True or False, # Whether the account's website is claimed or not.
"accountLevelIssues": [ # A list of account level issues.
{
"documentation": "A String", # The URL of a web page to help resolving this issue.
"severity": "A String", # Severity of the issue.
"title": "A String", # Short description of the issue.
"country": "A String", # Country for which this issue is reported.
"destination": "A String", # The destination the issue applies to.
"detail": "A String", # Additional details about the issue.
"id": "A String", # Issue identifier.
},
],
"products": [ # List of product-related data by channel, destination, and country. Data in this field may be delayed by up to 30 minutes.
{
"country": "A String", # The country the data applies to.
"itemLevelIssues": [ # List of item-level issues.
{
"code": "A String", # The error code of the issue.
"description": "A String", # A short issue description in English.
"documentation": "A String", # The URL of a web page to help with resolving this issue.
"attributeName": "A String", # The attribute's name, if the issue is caused by a single attribute.
"detail": "A String", # A detailed issue description in English.
"numItems": "A String", # Number of items with this issue.
"servability": "A String", # How this issue affects serving of the offer.
"resolution": "A String", # Whether the issue can be resolved by the merchant.
},
],
"destination": "A String", # The destination the data applies to.
"channel": "A String", # The channel the data applies to.
"statistics": { # Aggregated product statistics.
"active": "A String", # Number of active offers.
"expiring": "A String", # Number of expiring offers.
"disapproved": "A String", # Number of disapproved offers.
"pending": "A String", # Number of pending offers.
},
},
],
"dataQualityIssues": [ # DEPRECATED - never populated.
{
"displayedValue": "A String",
"severity": "A String",
"lastChecked": "A String",
"country": "A String",
"destination": "A String",
"detail": "A String",
"submittedValue": "A String",
"numItems": 42,
"location": "A String",
"id": "A String",
"exampleItems": [
{
"itemId": "A String",
"submittedValue": "A String",
"link": "A String",
"valueOnLandingPage": "A String",
"title": "A String",
},
],
},
],
"accountId": "A String", # The ID of the account for which the status is reported.
}
list(merchantId, pageToken=None, maxResults=None, destinations=None)
Lists the statuses of the sub-accounts in your Merchant Center account.
Args:
merchantId: string, The ID of the managing account. This must be a multi-client account. (required)
pageToken: string, The token returned by the previous request.
maxResults: integer, The maximum number of account statuses to return in the response, used for paging.
destinations: string, If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination. (repeated)
Returns:
An object of the form:
{
"nextPageToken": "A String", # The token for the retrieval of the next page of account statuses.
"kind": "content#accountstatusesListResponse", # Identifies what kind of resource this is. Value: the fixed string "content#accountstatusesListResponse".
"resources": [
{ # The status of an account, i.e., information about its products, which is computed offline and not returned immediately at insertion time.
"kind": "content#accountStatus", # Identifies what kind of resource this is. Value: the fixed string "content#accountStatus".
"websiteClaimed": True or False, # Whether the account's website is claimed or not.
"accountLevelIssues": [ # A list of account level issues.
{
"documentation": "A String", # The URL of a web page to help resolving this issue.
"severity": "A String", # Severity of the issue.
"title": "A String", # Short description of the issue.
"country": "A String", # Country for which this issue is reported.
"destination": "A String", # The destination the issue applies to.
"detail": "A String", # Additional details about the issue.
"id": "A String", # Issue identifier.
},
],
"products": [ # List of product-related data by channel, destination, and country. Data in this field may be delayed by up to 30 minutes.
{
"country": "A String", # The country the data applies to.
"itemLevelIssues": [ # List of item-level issues.
{
"code": "A String", # The error code of the issue.
"description": "A String", # A short issue description in English.
"documentation": "A String", # The URL of a web page to help with resolving this issue.
"attributeName": "A String", # The attribute's name, if the issue is caused by a single attribute.
"detail": "A String", # A detailed issue description in English.
"numItems": "A String", # Number of items with this issue.
"servability": "A String", # How this issue affects serving of the offer.
"resolution": "A String", # Whether the issue can be resolved by the merchant.
},
],
"destination": "A String", # The destination the data applies to.
"channel": "A String", # The channel the data applies to.
"statistics": { # Aggregated product statistics.
"active": "A String", # Number of active offers.
"expiring": "A String", # Number of expiring offers.
"disapproved": "A String", # Number of disapproved offers.
"pending": "A String", # Number of pending offers.
},
},
],
"dataQualityIssues": [ # DEPRECATED - never populated.
{
"displayedValue": "A String",
"severity": "A String",
"lastChecked": "A String",
"country": "A String",
"destination": "A String",
"detail": "A String",
"submittedValue": "A String",
"numItems": 42,
"location": "A String",
"id": "A String",
"exampleItems": [
{
"itemId": "A String",
"submittedValue": "A String",
"link": "A String",
"valueOnLandingPage": "A String",
"title": "A String",
},
],
},
],
"accountId": "A String", # The ID of the account for which the status is reported.
},
],
}
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.