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.
Arguments:
Name
Type
Description
name
String
Name of the label to apply.
asType()
Returns an AdViewSpace, which provides access to type-specific fields of the ad.
Returns the first line of the ad description. May return null for some types of ads.
Return values:
Type
Description
String
The first line of the ad description.
getDescription2()
Returns the second line of the ad description. May return null for some types of ads.
Return values:
Type
Description
String
The second line of the ad description.
getDisapprovalReasons()
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.
Return values:
Type
Description
String[]
The disapproval reasons of the ad.
getDisplayUrl()
Returns the display URL of the ad. May return null for some types of ads.
Return values:
Type
Description
String
The display URL of the ad.
getEntityType()
Returns the type of this entity as a String, in this case, "Ad".
Return values:
Type
Description
String
Type of this entity: "Ad".
getHeadline()
Returns the headline of the ad. May return null for some types of ads.
Return values:
Type
Description
String
The headline of the ad.
getId()
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. 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.
Arguments:
Name
Type
Description
dateFrom
Object
Start date of the date range. Must be either a string in YYYYMMDD form,
or an object with year, month and day properties.
dateTo
Object
End date of the date range. Must be either a string in YYYYMMDD form, or
an object with year, month and day properties.
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.
Arguments:
Name
Type
Description
name
String
Name of the label.
urls()
Provides access to this ad's URL fields. See Using Upgraded URLs for more
information.