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']
}
}