GetLimits

Returns the total number of images that the client can upload, as well as the number of images that have already been uploaded or are currently in the upload queue.

Input data

The input data structure in JSON is shown below.

{
   "method": "AdImage",
   "param": {
      /* AdImageRequest */
      "Action": (string),
      "SelectionCriteria": {
         /* AdImageSelectionCriteria */
         "Logins": [
            (string)
            ...
         ]
      }
   }
}

Parameters are described below.

Parameter Description Required
AdImageRequest object
Action Action: GetLimits. Yes
SelectionCriteria The AdImageSelectionCriteria object, which contains criteria for selecting usernames. For agencies
AdImageSelectionCriteria object
Logins

For agencies, an array containing the usernames of clients (no more than 1000) to get the number of images for.

For advertisers, this parameter is ignored.

For agencies
Parameter Description Required
AdImageRequest object
Action Action: GetLimits. Yes
SelectionCriteria The AdImageSelectionCriteria object, which contains criteria for selecting usernames. For agencies
AdImageSelectionCriteria object
Logins

For agencies, an array containing the usernames of clients (no more than 1000) to get the number of images for.

For advertisers, this parameter is ignored.

For agencies

Output data

The output data structure in JSON is shown below.

{
   "data": {
      /* AdImageResponse */
      "AdImageLimits": [
         {  /* AdImageLimit */
            "Login": (string),
            "Capacity": (int),
            "Utilized": (int)
         }
         ...
      ]
   }
}

Parameters are described below.

Parameter Description
AdImageResponse object
AdImageLimits Array of AdImageLimit objects.
AdImageLimit object
Login Client username.
Capacity The total number of images the client can upload.
Utilized The number of uploaded images, plus the number of upload tasks with the "Pending" status.
Parameter Description
AdImageResponse object
AdImageLimits Array of AdImageLimit objects.
AdImageLimit object
Login Client username.
Capacity The total number of images the client can upload.
Utilized The number of uploaded images, plus the number of upload tasks with the "Pending" status.

Examples of input data

Python

{
   'Action': 'GetLimits',
   'SelectionCriteria': {
      'Logins': ['agrom','larry']
   }
}

PHP

array(
   'Action' => 'GetLimits',
   'SelectionCriteria' => array(
      'Logins' => array('agrom','larry')
   )
)

Perl

{
   'Action' => 'GetLimits',
   'SelectionCriteria' => {
      'Logins' => ['agrom','larry']
   }
}