Click here to see your recently viewed pages and most viewed pages.
Hide
AdWords API

type AdGroupAd (v201502)

Represents an ad in an ad group.


Namespace
https://adwords.google.com/api/adwords/cm/v201502
Fields
Field Type Description
adGroupId
Filterable
Required
Selectable
xsd:long The id of the adgroup containing this ad. This field can be selected using the value "AdGroupId". This field can be filtered on. This field is required and should not be null.
experimentData AdGroupAdExperimentData Experiment data associated with this AdGroupAd. It is returned by get() only if the experimentId is supplied.
status
Filterable
Required
Selectable
AdGroupAd.Status The status of the ad. This field can be selected using the value "Status". This field can be filtered on. This field is required and should not be null when it is contained within Operators : SET.
Enumerations
ENABLED
Enabled.
PAUSED
Paused.
DISABLED
Disabled.
approvalStatus
Filterable
ReadOnly
Selectable
AdGroupAd.ApprovalStatus Approval status. This field can be selected using the value "AdGroupCreativeApprovalStatus". This field can be filtered on. This field is read only and will be ignored when sent to the API.
Enumerations
APPROVED
Approved
DISAPPROVED
Disapproved
FAMILY_SAFE
Approved - famiy safe
NON_FAMILY_SAFE
Approved - non-family safe
PORN
Approved - adult content
UNCHECKED
Pending review
UNKNOWN
trademarks
ReadOnly
Selectable
xsd:string[] A list of strings that represents the specific trademarked terms that were found in this ad. The list returned is empty if the ad has no trademarked terms. This field can be selected using the value "Trademarks". This field is read only and will be ignored when sent to the API.
disapprovalReasons
Filterable
ReadOnly
Selectable
xsd:string[] List of disapproval reasons. This field can be selected using the value "AdGroupAdDisapprovalReasons". This field can be filtered on. This field is read only and will be ignored when sent to the API.
trademarkDisapproved
ReadOnly
Selectable
xsd:boolean True if and only if this ad is not serving because it does not meet trademark policy. This field is only useful when approvalStatus is an approved status. This field can be selected using the value "AdGroupAdTrademarkDisapproved". This field is read only and will be ignored when sent to the API.
labels
Filterable
ReadOnly
Selectable
  1. Label[]
    1. TextLabel
Labels that are attached to the AdGroupAd. To associate an existing Label to an existing AdGroupAd, use AdGroupAdService.mutateLabel with ADD operator. To remove an associated Label from the AdGroupAd, use AdGroupAdService.mutateLabel with REMOVE operator. To filter on Labels, use one of Predicate.Operator.CONTAINS_ALL, Predicate.Operator.CONTAINS_ANY, Predicate.Operator.CONTAINS_NONE operators with a list of Label ids. This field can be selected using the value "Labels". This field can be filtered on. This field is read only and will be ignored when sent to the API for the following Operators: REMOVE and SET.
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.