Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13177414729.5 KB
advertisers

Creates a new ad group. Returns the newly created ad group if successful. This method is only supported for Demand Gen ad groups.

post/v4/advertisers/{+advertiserId}/adGroups

Path parameters

advertiserIdstring required

Output only. The unique ID of the advertiser the ad group belongs to.

Request body

adGroupIdstring int64

Output only. The unique ID of the ad group. Assigned by the system.

entityStatus'ENTITY_STATUS_UNSPECIFIED' | 'ENTITY_STATUS_ACTIVE' | 'ENTITY_STATUS_ARCHIVED' | 'ENTITY_STATUS_DRAFT' | 'ENTITY_STATUS_PAUSED' | 'ENTITY_STATUS_SCHEDULED_FOR_DELETION'

Required. Controls whether or not the ad group can spend its budget and bid on inventory. If the ad group's parent line item is not active, the ad group can't spend its budget even if its own status is ENTITY_STATUS_ACTIVE.

lineItemIdstring int64

Required. Immutable. The unique ID of the line item that the ad group belongs to.

advertiserIdstring int64

Output only. The unique ID of the advertiser the ad group belongs to.

namestring

Output only. Identifier. The resource name of the ad group.

displayNamestring

Required. The display name of the ad group. Must be UTF-8 encoded with a maximum size of 255 bytes.

adGroupFormat'AD_GROUP_FORMAT_UNSPECIFIED' | 'AD_GROUP_FORMAT_IN_STREAM' | 'AD_GROUP_FORMAT_VIDEO_DISCOVERY' | 'AD_GROUP_FORMAT_BUMPER' | 'AD_GROUP_FORMAT_NON_SKIPPABLE_IN_STREAM' | 'AD_GROUP_FORMAT_AUDIO' | 'AD_GROUP_FORMAT_RESPONSIVE' | 'AD_GROUP_FORMAT_REACH' | 'AD_GROUP_FORMAT_MASTHEAD' | 'AD_GROUP_FORMAT_DEMAND_GEN'

Required. Immutable. The format of the ads in the ad group.

Response

Successful response