Content API for Shopping . accountstatuses

Instance Methods

close()

Close httplib2 connections.

custombatch(body=None, x__xgafv=None)

Retrieves multiple Merchant Center account statuses in a single request.

get(merchantId, accountId, destinations=None, x__xgafv=None)

Retrieves the status of a Merchant Center account. No itemLevelIssues are returned for multi-client accounts.

list(merchantId, destinations=None, maxResults=None, name=None, pageToken=None, x__xgafv=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.

Method Details

close()
Close httplib2 connections.
custombatch(body=None, x__xgafv=None)
Retrieves multiple Merchant Center account statuses in a single request.

Args:
  body: object, The request body.
    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.
      "accountId": "A String", # The ID of the (sub-)account whose status to get.
      "batchId": 42, # An entry ID, unique within the batch request.
      "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.
      "method": "A String", # The method of the batch entry. Acceptable values are: - "`get`"
    },
  ],
}

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

Returns:
  An object of the form:

    {
  "entries": [ # The result of the execution of the batch requests.
    { # A batch entry encoding a single non-batch accountstatuses response.
      "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.
        "accountId": "A String", # The ID of the account for which the status is reported.
        "accountLevelIssues": [ # A list of account level issues.
          {
            "country": "A String", # Country for which this issue is reported.
            "destination": "A String", # The destination the issue applies to. If this field is empty then the issue applies to all available destinations.
            "detail": "A String", # Additional details about the issue.
            "documentation": "A String", # The URL of a web page to help resolving this issue.
            "id": "A String", # Issue identifier.
            "severity": "A String", # Severity of the issue. Acceptable values are: - "`critical`" - "`error`" - "`suggestion`"
            "title": "A String", # Short description of the issue.
          },
        ],
        "accountManagement": "A String", # How the account is managed. Acceptable values are: - "`manual`" - "`automatic`"
        "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accountStatus`"
        "products": [ # List of product-related data by channel, destination, and country. Data in this field may be delayed by up to 30 minutes.
          {
            "channel": "A String", # The channel the data applies to. Acceptable values are: - "`local`" - "`online`"
            "country": "A String", # The country the data applies to.
            "destination": "A String", # The destination the data applies to.
            "itemLevelIssues": [ # List of item-level issues.
              {
                "attributeName": "A String", # The attribute's name, if the issue is caused by a single attribute.
                "code": "A String", # The error code of the issue.
                "description": "A String", # A short issue description in English.
                "detail": "A String", # A detailed issue description in English.
                "documentation": "A String", # The URL of a web page to help with resolving this issue.
                "numItems": "A String", # Number of items with this issue.
                "resolution": "A String", # Whether the issue can be resolved by the merchant.
                "servability": "A String", # How this issue affects serving of the offer.
              },
            ],
            "statistics": { # Aggregated product statistics.
              "active": "A String", # Number of active offers.
              "disapproved": "A String", # Number of disapproved offers.
              "expiring": "A String", # Number of expiring offers.
              "pending": "A String", # Number of pending offers.
            },
          },
        ],
        "websiteClaimed": True or False, # Whether the account's website is claimed or not.
      },
      "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.
        "code": 42, # The HTTP status of the first error in `errors`.
        "errors": [ # A list of errors.
          { # An error returned by the API.
            "domain": "A String", # The domain of the error.
            "message": "A String", # A description of the error.
            "reason": "A String", # The error code.
          },
        ],
        "message": "A String", # The message of the first error in `errors`.
      },
    },
  ],
  "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accountstatusesCustomBatchResponse`".
}
get(merchantId, accountId, destinations=None, x__xgafv=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)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

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.
  "accountId": "A String", # The ID of the account for which the status is reported.
  "accountLevelIssues": [ # A list of account level issues.
    {
      "country": "A String", # Country for which this issue is reported.
      "destination": "A String", # The destination the issue applies to. If this field is empty then the issue applies to all available destinations.
      "detail": "A String", # Additional details about the issue.
      "documentation": "A String", # The URL of a web page to help resolving this issue.
      "id": "A String", # Issue identifier.
      "severity": "A String", # Severity of the issue. Acceptable values are: - "`critical`" - "`error`" - "`suggestion`"
      "title": "A String", # Short description of the issue.
    },
  ],
  "accountManagement": "A String", # How the account is managed. Acceptable values are: - "`manual`" - "`automatic`"
  "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accountStatus`"
  "products": [ # List of product-related data by channel, destination, and country. Data in this field may be delayed by up to 30 minutes.
    {
      "channel": "A String", # The channel the data applies to. Acceptable values are: - "`local`" - "`online`"
      "country": "A String", # The country the data applies to.
      "destination": "A String", # The destination the data applies to.
      "itemLevelIssues": [ # List of item-level issues.
        {
          "attributeName": "A String", # The attribute's name, if the issue is caused by a single attribute.
          "code": "A String", # The error code of the issue.
          "description": "A String", # A short issue description in English.
          "detail": "A String", # A detailed issue description in English.
          "documentation": "A String", # The URL of a web page to help with resolving this issue.
          "numItems": "A String", # Number of items with this issue.
          "resolution": "A String", # Whether the issue can be resolved by the merchant.
          "servability": "A String", # How this issue affects serving of the offer.
        },
      ],
      "statistics": { # Aggregated product statistics.
        "active": "A String", # Number of active offers.
        "disapproved": "A String", # Number of disapproved offers.
        "expiring": "A String", # Number of expiring offers.
        "pending": "A String", # Number of pending offers.
      },
    },
  ],
  "websiteClaimed": True or False, # Whether the account's website is claimed or not.
}
list(merchantId, destinations=None, maxResults=None, name=None, pageToken=None, x__xgafv=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)
  destinations: string, If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination. (repeated)
  maxResults: integer, The maximum number of account statuses to return in the response, used for paging.
  name: string, If set, only the accounts with the given name (case sensitive) will be returned.
  pageToken: string, The token returned by the previous request.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
  "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accountstatusesListResponse`".
  "nextPageToken": "A String", # The token for the retrieval of the next page of account statuses.
  "resources": [
    { # The status of an account, i.e., information about its products, which is computed offline and not returned immediately at insertion time.
      "accountId": "A String", # The ID of the account for which the status is reported.
      "accountLevelIssues": [ # A list of account level issues.
        {
          "country": "A String", # Country for which this issue is reported.
          "destination": "A String", # The destination the issue applies to. If this field is empty then the issue applies to all available destinations.
          "detail": "A String", # Additional details about the issue.
          "documentation": "A String", # The URL of a web page to help resolving this issue.
          "id": "A String", # Issue identifier.
          "severity": "A String", # Severity of the issue. Acceptable values are: - "`critical`" - "`error`" - "`suggestion`"
          "title": "A String", # Short description of the issue.
        },
      ],
      "accountManagement": "A String", # How the account is managed. Acceptable values are: - "`manual`" - "`automatic`"
      "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#accountStatus`"
      "products": [ # List of product-related data by channel, destination, and country. Data in this field may be delayed by up to 30 minutes.
        {
          "channel": "A String", # The channel the data applies to. Acceptable values are: - "`local`" - "`online`"
          "country": "A String", # The country the data applies to.
          "destination": "A String", # The destination the data applies to.
          "itemLevelIssues": [ # List of item-level issues.
            {
              "attributeName": "A String", # The attribute's name, if the issue is caused by a single attribute.
              "code": "A String", # The error code of the issue.
              "description": "A String", # A short issue description in English.
              "detail": "A String", # A detailed issue description in English.
              "documentation": "A String", # The URL of a web page to help with resolving this issue.
              "numItems": "A String", # Number of items with this issue.
              "resolution": "A String", # Whether the issue can be resolved by the merchant.
              "servability": "A String", # How this issue affects serving of the offer.
            },
          ],
          "statistics": { # Aggregated product statistics.
            "active": "A String", # Number of active offers.
            "disapproved": "A String", # Number of disapproved offers.
            "expiring": "A String", # Number of expiring offers.
            "pending": "A String", # Number of pending offers.
          },
        },
      ],
      "websiteClaimed": True or False, # Whether the account's website is claimed or not.
    },
  ],
}
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.