/display/v2/advertisers/{advertiserId}/campaigns/{campaignId}/display/ad-groups/{adGroupId}

PUT

https://<pcm-domain>/display/v2/advertisers/{advertiserId}/campaigns/{campaignId}/display/ad-groups/{adGroupId}

Update a DISPLAY or SPONSORED_BRAND ad-group.

Rules

name of an ad group under a campaign must be unique.
startDate must be before endDate.
startDate must be a present or future date.
startDate can only be modified if the current start date is a future date.
budget must always be greater than equal to budgetSpent.
dailyBudget must always be less than or equal to budget.
dailyBudget must always be less than or equal to monthBudget.
dailyBudget must always be less than or equal to weeklyBudget.
weeklyBudget must always be less than or equal to budget.
weeklyBudget must always be less than or equal to monthBudget.
monthlyBudget must always be less than or equal to budget.
dailySpendPacing can only be EVEN whenever dailyBudget is set or useDynamicBudget is true.
The adUnitId targeted in the buyout request should support at least one of the sizes of the ad-groups creatives.
The shareOfVoicePercentage for a keywords/category buyout must be between 1 and 100 and the sum of shareOfVoicePercentage for all ad-groups targeting the same adUnitId and the same keyword/category must not exceed 100.
equalShareOfVoice can only be true if all other ad-groups targeting the same adUnitId and the same keyword/category also have equalShareOfVoice set to true. If equalShareOfVoice is true for an ad-group then the shareOfVoicePercentage for that ad-group is automatically calculated as 100 divided by the number of ad-groups targeting the same adUnitId and the same keyword/category.

Note:

In order to drop endDate, dailyBudget, weeklyBudget or monthlyBudget explicitly set these fields to null in the request body.

advertiserIdinteger<int32>

campaignIdinteger<int32>

adGroupIdinteger<int32>

acceptstringGenerated from available response content types

bodyobject

200OK

401Unauthorized

403Forbidden

404Not Found

422Unprocessable Entity

curl --request PUT \
     --url https://<pcm-domain>/display/v2/advertisers/{advertiserId}/campaigns/{campaignId}/display/ad-groups/{adGroupId} \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "buyout": {
     "enabled": ""
     }
     }'