Applies a label to the ad.
Applies a label to the ad.
name
of the label is case-sensitive. Operation will fail if the label with the specified name does not already exist in the account.
Note that the ad cannot not have more than 50 labels.
Returns nothing.
Enables the ad.
Enables the ad.
Returns nothing.
Returns the ad group to which this ad belongs.
Returns the approval status of the ad.
Returns the approval status of the ad. Possible values:
APPROVED, DISAPPROVED, FAMILY_SAFE, NON_FAMILY_SAFE, PORN, UNCHECKED
.
Returns the campaign to which this ad belongs.
Returns the first line of the ad description.
Returns the first line of the ad description. May return
null
for some types of ads.
Returns the second line of the ad description.
Returns the second line of the ad description. May return
null
for some types of ads.
Returns the destination URL of the ad.
Returns the destination URL of the ad. <aside class="warning"> Deprecated. This method is deprecated. Destination URLs will become read-only on July 1, 2015. We recommend that you upgrade to using final URLs instead. See Using Upgraded URLs for more information. </aside>
Returns the array of disapproval reasons.
Returns the array of disapproval reasons.
The returned array will contain entries like 'Editorial Standards-Spacing', 'Inaccurate Display URL', etc. An empty array will be returned if the ad has not been disapproved.
Returns the display URL of the ad.
Returns the display URL of the ad. May return
null
for some types of ads.
Returns the type of this entity as a
String
, in this case,
"Ad"
.
Returns the type of this entity as a
String
, in this case,
"Ad"
.
Returns the headline of the ad.
Returns the headline of the ad. May return
null
for some types of ads.
Returns the ID of the ad.
Returns the ID of the ad.
Ad IDs may be shared across ad groups. In order to uniquely identify one ad, one must specify both its ad group ID and its creative ID.
Returns stats for the specified custom date range.
Returns stats for the specified custom date range. Both parameters can be either an object containing year, month, and day fields, or an 8-digit string in
YYYYMMDD
form. For instance,
March 24th, 2013
is represented as either
{year: 2013, month: 3, day: 24}
or
"20130324"
. The date range is inclusive on both ends, so
forDateRange("20130324", "20130324")
defines a range of a single day.
Returns the type of the ad.
Returns the type of the ad. Possible values:
IMAGE_AD, MOBILE_AD, MOBILE_IMAGE_AD, PRODUCT_AD, RICH_MEDIA_AD, TEMPLATE_AD, TEXT_AD
.
Returns
true
if the ad is enabled.
Returns
true
if the ad is enabled.
Returns
true
if the ad specifies mobile device preference or
false
otherwise.
Returns
true
if the ad specifies mobile device preference or
false
otherwise.
Returns
true
if the ad is paused.
Returns
true
if the ad is paused.
Creates a selector of all labels applied to the ad.
Pauses the ad.
Pauses the ad.
Returns nothing.
Removes the ad.
Removes the ad.
Returns nothing.
Removes a label from the ad.
Removes a label from the ad.
name
of the label is case-sensitive. Operation will fail if the label with the specified name does not already exist in the account.
Returns nothing.
Provides access to this ad's URL fields.
Provides access to this ad's URL fields. See Using Upgraded URLs for more information.
Represents an AdWords ad.