AdWords API

AdWords API
Feedback on this document

type AdGroup (v201302)

Service
AdGroupService MutateJobService
Dependencies
AdGroupOperation Operand
▼
AdGroup

Represents an ad group.

Namespace
https://adwords.google.com/api/adwords/cm/v201302
Fields
Field Type Description
id
Filterable
ReadOnly
Required
Selectable
 xsd:long ID of this ad group. This field can be selected using the value "Id". This field can be filtered on. This field is read only and should not be set for following Operators : ADD. If this field is sent to the API, it will be ignored. This field is required and should not be null when it is contained within Operators : SET.
campaignId
Filterable
Required
Selectable
 xsd:long ID of the campaign with which this ad group is associated. This field can be selected using the value "CampaignId". This field can be filtered on. This field is required and should not be null when it is contained within Operators : ADD.
campaignName
Filterable
ReadOnly
Selectable
 xsd:string Name of the campaign with which this ad group is associated. This field can be selected using the value "CampaignName". This field can be filtered on. This field is read only and should not be set. If this field is sent to the API, it will be ignored.
name
Filterable
Selectable
 xsd:string Name of this ad group (at most 255 UTF-8 full-width characters). This field can be selected using the value "Name". This field can be filtered on.
status
Filterable
Selectable
 AdGroup.Status Status of this ad group. This field can be selected using the value "Status". This field can be filtered on.
Enumerations
ENABLED
Active.
PAUSED
Paused.
DELETED
Deleted.
settings
Selectable
  1. Setting[]
    1. GeoTargetTypeSetting
    2. KeywordMatchSetting
    3. RealTimeBiddingSetting
    4. TargetingSetting
    5. TrackingSetting
List of settings for the AdGroup. This field can be selected using the value "Settings".
experimentData AdGroupExperimentData Data from a campaign bidding strategy experiment, returned by get() only if the experimentId is supplied.
stats
  1. Stats
    1. AdExtensionOverrideStats
    2. AdStats
    3. CampaignAdExtensionStats
    4. CampaignStats
Statistics for this ad group, returned by get() only if requested in the selector.
forwardCompatibilityMap String_StringMapEntry[] This Map provides a place to put new features and settings in older versions of the AdWords API in the rare instance we need to introduce a new feature in an older version. It is presently unused. Do not set a value.
biddingStrategyConfiguration BiddingStrategyConfiguration Bidding configuration for this ad group. To set the bids on the ad groups use BiddingStrategyConfiguration.bids. Multiple bids can be set on ad group at the same time. Only the bids that apply to the campaign's bidding strategy bidding strategy will be used.
contentBidCriterionTypeGroup
Filterable
Selectable
 CriterionTypeGroup Allows advertisers to specify a criteria dimension on which to place absolute bids. This is only applicable for campaigns that target only the content network and not search. This field can be selected using the value "ContentBidCriterionTypeGroup". This field can be filtered on.
Enumerations
KEYWORD
Criteria for targeting keywords. e.g. 'mars cruise' KEYWORD may be used as a content bid dimension. Keywords are always a targeting dimension, so may not be set as a target "ALL" dimension with TargetRestriction.
USER_INTEREST_AND_LIST
Criteria for targeting lists of users. Lists may represent users with particular interests, or they may represent users who have interacted with an advertiser's site in particular ways.
VERTICAL
Criteria for targeting similar categories of placements, e.g. 'category::Animals>Pets' Used only for content network targeting.
GENDER
Criteria for targeting gender.
AGE_RANGE
Criteria for targeting age ranges.
PLACEMENT
Criteria for targeting placements. aka Website. e.g. 'www.flowers4sale.com' This group also includes mobile applications and mobile app categories.
UNKNOWN
Used for return value only. An enumeration could not be processed, typically due to incompatibility with your WSDL version.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.