AdsApp.ResponsiveSearchAd
Stay organized with collections
Save and categorize content based on your preferences.
Represents a responsive ad for Search. Methods:
applyLabel(name)
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 have more than 50 labels.
Returns nothing.
Arguments:
asType()
Returns an AdViewSpace
, which
provides access to type-specific fields of the ad. Return values:
enable()
Enables the ad. Returns nothing.
getAdGroup()
Returns the ad group to which this ad belongs. Return values:
getCampaign()
Returns the campaign to which this ad belongs or null
if it does not belong to a search or display campaign. Return values:
getDescriptions()
Returns the descriptions of the ad. Return values:
getEntityType()
Returns the type of this entity as a String
, in this case, "Ad"
. Return values:
getHeadlines()
Returns the headlines of the ad. Return values:
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.
Return values:
getPath1()
Returns the first path that appears with the ad's displayed URL, if it has
one. Return values:
getPath2()
Returns the second path that appears with the ad's displayed URL, if it has
one. Return values:
getPolicyApprovalStatus()
Returns the policy approval status of the ad. For a full list of policy
approval statuses, please see the Google
Ads API documentation on policy approval statuses
. Return values:
getPolicyTopics()
Returns the list of policy topics associated with the ad. Return values:
getResourceName()
Returns the resource name of the ad. Return values:
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
=
ad
.
getStatsFor
(
"THIS_MONTH"
);
Arguments:
Return values:
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:
Return values:
getType()
Returns the type of the ad. Possible values: EXPANDED_TEXT_AD,
IMAGE_AD, MOBILE_AD, MOBILE_IMAGE_AD, PRODUCT_AD, RICH_MEDIA_AD,
TEMPLATE_AD, TEXT_AD
. We recommend using ResponsiveSearchAd.isType
for fully supported types.
Return values:
isEnabled()
Returns true
if the ad is enabled. Return values:
isPaused()
Returns true
if the ad is paused. Return values:
isType()
Returns an AdTypeSpace
, which
determines the type of the ad. Return values:
labels()
Creates a selector of all labels applied to the ad. Return values:
pause()
Pauses the ad. Returns nothing.
remove()
Removes the ad. Returns nothing.
removeLabel(name)
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:
urls()
Provides access to this ad's URL fields. See Using Upgraded
URLs
for more information. Return values:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eRepresents a responsive search ad, providing a flexible ad format that adapts to various search queries.\u003c/p\u003e\n"],["\u003cp\u003eOffers methods for managing the ad, including applying labels, enabling/pausing, and retrieving performance statistics.\u003c/p\u003e\n"],["\u003cp\u003eAllows access to ad components like headlines, descriptions, and URLs for customization.\u003c/p\u003e\n"],["\u003cp\u003eIncludes functionalities for checking policy compliance and ad approval status.\u003c/p\u003e\n"],["\u003cp\u003eProvides tools to retrieve ad information, such as ID, associated ad group, and campaign.\u003c/p\u003e\n"]]],[],null,[]]
