groups.create
Create a new Groups in campaigns.
Parameters
| struct |
user { |
|
| string |
session |
Session (as retrieved from client.loginByToken())
|
| int |
userId |
(optional) Managed user ID
|
|
} |
|
|
| array |
groups ( |
|
| struct |
{ |
|
| int |
campaignId |
Campaign id
|
| int |
cpc |
Group default maximal cost per click (in halers)
|
| int |
cpt |
(optional) Group cost per thousand impressions,
|
| string |
status |
(optional) status of group: [default: active]
-
active:
active state
-
suspend:
suspend state
|
| int |
maxUserDailyImpression |
(optional) Max impressions of group per one user per one day
|
| struct |
devicesPriceRatio { |
(optional) Specify max CPC/CPT for target devices, in whole percents relative to group's CPC/CPT.
|
| int |
desktop |
(optional) (can be null) Desktop/Notebook devices
|
| int |
mobile |
(optional) (can be null) Smartphones/Mobile devices
|
| int |
tablet |
(optional) (can be null) Tablet devices
|
| int |
other |
(optional) (can be null) Other devices
|
|
} |
|
|
|
} |
|
|
|
) |
|
|
Response
| struct |
{ |
|
| string |
statusMessage |
Status code description
|
| string |
session |
Refreshed session
|
| array |
groupIds ( |
Group IDs of new created groups
|
|
|
) |
|
|
| array |
diagnostics ( |
(optional) Various diagnostics(warnings, errors, other information)
|
|
|
) |
|
|
|
} |
|
|
Response status codes:
List of all possible response status codes:
200: OK206: Partially OK301: User is serviced400: Bad arguments401: Invalid session403: Access Denied404: Not found406: Bad values of attributes413: Too many items requested.429: Too many requests. Has to wait.500: Server Error.409: Conflict
Diagnostics:
List of all possible diagnostics:
campaign_access_deniedcampaign_name_missingfloating_invalid_attributegroup_cpc_is_too_highgroup_cpc_is_too_lowgroup_cpm_out_of_rangegroup_maxUserDailyImpression_out_of_rangegroup_name_duplicitygroup_name_missingnot_allowed_for_campaign_typesimple_ads_invalid_attributeuser_access_denied
