AdsApp.​NegativeKeyword

AI-generated Key Takeaways

• Represents a Google Ads negative keyword, preventing ads from showing on searches with those terms.

• Negative keywords can be applied at the ad group level or the campaign level for more granular control.

• Provides methods to access and manage negative keyword data, such as text, match type, and associated campaigns/ad groups.

• Allows retrieval of negative keyword information for different campaign types, including Search, Display, Shopping, and Video.

• Enables the removal of negative keywords using the remove() method.

Represents a Google Ads negative keyword.

Negative keywords can exist either at the ad group level or the campaign level.

Methods:

Member	Type	Description
getAdGroup()	AdsApp.AdGroup	Returns the AdGroup to which the negative keyword belongs.
getBaseAdGroup()	AdsApp.AdGroup	Returns the base AdGroup to which the negative keyword belongs.
getBaseCampaign()	AdsApp.Campaign	Returns the base campaign to which this negative keyword belongs or null if it does not belong to a search or display campaign.
getCampaign()	AdsApp.Campaign	Returns the campaign to which this negative keyword belongs or null if it does not belong to a search or display campaign.
getCampaignType()	String	Returns the campaign type.
getEntityType()	String	Returns the type of this entity as a String, in this case, "NegativeKeyword".
getMatchType()	String	Returns the match type of the negative keyword.
getShoppingAdGroup()	AdsApp.ShoppingAdGroup	Returns the ShoppingAdGroup to which the negative keyword belongs.
getShoppingCampaign()	AdsApp.ShoppingCampaign	Returns the shopping campaign to which this negative keyword belongs or null if it does not belong to a shopping campaign.
getText()	String	Returns the text of the negative keyword.
remove()	void	Removes the negative keyword.

getAdGroup()

Returns the AdGroup to which the negative keyword belongs. This will return null for campaign-level negative keywords and negative keywords which do not belong to a search or display ad group.

Return values:

Type	Description
AdsApp.AdGroup	The AdGroup to which the negative keyword belongs.

getBaseAdGroup()

Returns the base AdGroup to which the negative keyword belongs. This will return null for campaign-level negative keywords and negative keywords which do not belong to a search or display ad group.

Return values:

Type	Description
AdsApp.AdGroup	The base AdGroup to which the negative keyword belongs.

getBaseCampaign()

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

Return values:

Type	Description
AdsApp.Campaign	The base campaign to which this negative keyword belongs or null if it does not belong to a search or display campaign.

getCampaign()

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

Return values:

Type	Description
AdsApp.Campaign	The campaign to which this negative keyword belongs or null if it does not belong to a search or display campaign.

getCampaignType()

Returns the campaign type. Possible return values:

SEARCH_OR_DISPLAY, VIDEO, SHOPPING

Return values:

Type	Description
String	Video campaign type.

getEntityType()

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

Return values:

Type	Description
String	Type of this entity: "NegativeKeyword".

getMatchType()

Returns the match type of the negative keyword. Possible values: BROAD, PHRASE, EXACT.

Return values:

Type	Description
String	The match type of the negative keyword.

getShoppingAdGroup()

Returns the ShoppingAdGroup to which the negative keyword belongs. This will return null for campaign-level negative keywords and negative keywords which do not belong to a shopping ad group.

Return values:

Type	Description
AdsApp.ShoppingAdGroup	The ShoppingAdGroup to which the negative keyword belongs.

getShoppingCampaign()

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

Return values:

Type	Description
AdsApp.ShoppingCampaign	The shopping campaign to which this negative keyword belongs or null if it does not belong to a shopping campaign.

getText()

Returns the text of the negative keyword. The returned value will be formatted as follows, depending on the match type:

• shoes - broad match
• "shoes" - phrase match
• [leather shoes] - exact match

Return values:

Type	Description
String	The text of the negative keyword.

remove()

Removes the negative keyword.

Returns nothing.