AdWords API
Feedback on this document

type AdGroup (v201209)

Service
AdGroupService MutateJobService
Dependencies
AdGroupOperation Operand
▼
AdGroup

Represents an ad group.

Namespace
https://adwords.google.com/api/adwords/cm/v201209
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. TargetRestrictSetting
    5. TargetingSetting
    6. TrackingSetting
List of settings for the AdGroup. This field can be selected using the value "Settings".
bids
  1. AdGroupBids
    1. BudgetOptimizerAdGroupBids
    2. ConversionOptimizerAdGroupBids
    3. ManualCPCAdGroupBids
    4. ManualCPMAdGroupBids
    5. PercentCPAAdGroupBids
The default bid amounts for criteria in this ad group. The type of bid (i.e. the type of this field) must match the parent campaign's bidding strategy.
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.

Authentication required

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

Signing you in...

Google Developers needs your permission to do that.