AdsApp.​DisplayKeyword

Represents a Google Ads display keyword.

Methods:

MemberTypeDescription
biddingAdsApp.DisplayCriterionBiddingProvides access to this display keyword's bidding fields.
getAdGroupAdsApp.AdGroupReturns the ad group to which this display keyword belongs.
getBaseAdGroupAdsApp.AdGroupReturns the base ad group to which this display keyword belongs.
getBaseCampaignAdsApp.CampaignReturns the base campaign to which this display keyword belongs.
getCampaignAdsApp.CampaignReturns the campaign to which this display keyword belongs or null if it does not belong to a search or display campaign.
getEntityTypeStringReturns the type of this entity as a String, in this case, "DisplayKeyword".
getIdStringReturns the ID of the display keyword.
getResourceNameStringReturns the resource name of the display keyword.
getStatsForAdsApp.StatsReturns stats for the specified date range.
getStatsForAdsApp.StatsReturns stats for the specified custom date range.
getTextStringReturns the text of the display keyword.
isEnabledbooleanReturns true if the display keyword is enabled.
isPausedbooleanReturns true if the display keyword is paused.
removevoidRemoves the display keyword.

bidding()

Provides access to this display keyword's bidding fields.

Return values:

TypeDescription
AdsApp.DisplayCriterionBiddingAccess to this display keyword's bidding fields.

getAdGroup()

Returns the ad group to which this display keyword belongs.

Return values:

TypeDescription
AdsApp.AdGroupThe ad group to which this display keyword belongs.

getBaseAdGroup()

Returns the base ad group to which this display keyword belongs.

Return values:

TypeDescription
AdsApp.AdGroupThe base ad group to which this display keyword belongs.

getBaseCampaign()

Returns the base campaign to which this display keyword belongs.

Return values:

TypeDescription
AdsApp.CampaignThe base campaign to which this display keyword belongs.

getCampaign()

Returns the campaign to which this display keyword belongs or null if it does not belong to a search or display campaign.

Return values:

TypeDescription
AdsApp.CampaignThe campaign to which this display keyword belongs or null if it does not belong to a search or display campaign.

getEntityType()

Returns the type of this entity as a String, in this case, "DisplayKeyword".

Return values:

TypeDescription
StringType of this entity: "DisplayKeyword".

getId()

Returns the ID of the display keyword.

Return values:

TypeDescription
StringThe ID of the display keyword.

getResourceName()

Returns the resource name of the display keyword.

Return values:

TypeDescription
StringThe resource name of the display keyword.

getStatsFor(dateRange)

Returns stats for the specified date range. Supported values:

TODAY, YESTERDAY, LAST_7_DAYS, THIS_WEEK_SUN_TODAY, LAST_WEEK, LAST_14_DAYS, LAST_30_DAYS, LAST_BUSINESS_WEEK, LAST_WEEK_SUN_SAT, THIS_MONTH, LAST_MONTH, ALL_TIME.

Example:

var stats = displayKeyword.getStatsFor("THIS_MONTH");

Arguments:

NameTypeDescription
dateRangeStringDate range for which the stats are requested.

Return values:

TypeDescription
AdsApp.StatsThe stats for the specified date range.

getStatsFor(dateFrom, dateTo)

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:

NameTypeDescription
dateFromObjectStart date of the date range. Must be either a string in YYYYMMDD form, or an object with year, month and day properties.
dateToObjectEnd date of the date range. Must be either a string in YYYYMMDD form, or an object with year, month and day properties.

Return values:

TypeDescription
AdsApp.StatsThe stats for the specified date range.

getText()

Returns the text of the display keyword.

Return values:

TypeDescription
StringThe text of the display keyword.

isEnabled()

Returns true if the display keyword is enabled.

Return values:

TypeDescription
booleantrue if the display keyword is enabled.

isPaused()

Returns true if the display keyword is paused.

Return values:

TypeDescription
booleantrue if the display keyword is paused.

remove()

Removes the display keyword.

Returns nothing.