AdGroup

包含用于管理广告组的方法。

方法

方法名称	返回类型	说明
addLocation (int locationId)	TargetedLocationOperation	根据位置 ID 在此广告组中创建位置定位。
addLocation (int locationId， double bidModifier)	TargetedLocationOperation	根据位置 ID 和出价修改符创建此广告组中的地理位置定位条件。
广告	AdSelector	获取用于筛选此广告组中的广告列表的选择器。
applyLabel (字符串名称)	void	将标签应用于此广告组。
出价	AdGroupBidding	获取用于管理此广告组出价金额的方法。
启用	void	启用此广告组。
excludeLocation (int locationId)	ExcludedLocationOperation	从位置 ID 在此广告组中创建位置排除。
getCampaign	市场活动	获取此广告组所属的市场活动。
getEndDate	BingAdsDate	获取此广告组中的广告停止投放的日期。
getEntityType	string	获取此实体的类型。
getId	string	获取唯一标识此广告组的 ID。
getName	string	获取此广告组的名称。
getStartDate	BingAdsDate	获取此广告组中的广告开始投放的日期。
getStats	统计	获取此广告组的效果数据。
isEnabled	布尔值	获取指示是否启用此广告组的布尔值。
isPaused	布尔值	获取指示此广告组是否已暂停的布尔值。
isRemoved	布尔值	获取指示是否删除此广告组的布尔值。
keywords	KeywordSelector	获取用于筛选此广告组中关键字列表的选择器。
标签	LabelSelector	获取用于筛选与此广告组关联的标签列表的选择器。
newAd	AdBuilderSpace	获取包含用于获取广告生成器的方法的对象。
newKeywordBuilder	KeywordBuilder	获取用于向此广告组添加关键字 (keyword) 的生成器。
暂停	void	暂停此广告组。
productGroups	ProductGroupSelector	获取用于筛选此广告组中产品组列表的选择器。
removeLabel (字符串名称)	void	从此广告组中删除标签。
rootProductGroup	ProductGroup	获取此广告组的根产品组。
setEndDate (字符串 endDate)	void	设置此广告组中的广告停止投放的日期。
setEndDate (对象 endDate)	void	设置此广告组中的广告停止投放的日期。
setName (字符串名称)	void	设置广告组的名称。
setStartDate (字符串 startDate)	void	设置此广告组中的广告开始投放的日期。
setStartDate (对象 startDate)	void	设置此广告组中的广告开始投放的日期。
目标	AdGroupTargeting	提供对广告组级别定位条件的访问权限：地理位置定位。
urls	AdGroupUrls	包含用于管理此广告组的最终 URL、跟踪模板和自定义参数的方法。

addLocation (int locationId)

根据位置 ID 在此广告组中创建位置定位。

类型	说明
TargetedLocationOperation	用于检查目标位置是否添加成功的操作对象。

addLocation (int locationId， double bidModifier)

根据位置 ID 和出价修改符创建此广告组中的地理位置定位条件。

类型	说明
TargetedLocationOperation	用于检查目标位置是否添加成功的操作对象。

类型	说明
AdSelector	用于筛选此广告组中的广告列表的选择器。

applyLabel (字符串名称)

将标签应用于广告组。

最多可以向广告组应用 50 个标签。有关向实体添加标签的示例，请参阅使用标签。

参数

名称	类型	说明
name	string	标签的名称（区分大小写）。若要获取此帐户中可应用的标签列表，请参阅 AdsApp.labels。

类型	说明
void	不返回任何内容。

出价

获取用于管理此广告组出价金额的方法。

类型	说明
AdGroupBidding	包含管理此广告组出价金额的方法。

启用

启用此广告组。

类型	说明
void	不返回任何内容。

excludeLocation (int locationId)

从位置 ID 在此广告组中创建位置排除。

类型	说明
ExcludedLocationOperation	用于检查是否已成功添加排除位置的操作对象。

getCampaign

获取此广告组所属的市场活动。

类型	说明
市场活动	此广告组所属的市场活动。

getEndDate

获取此广告组中的广告停止投放的日期。

类型	说明
BingAdsDate	此广告组中的广告停止投放的日期。

getEntityType

获取此实体的类型。

类型	说明
string	此实体的类型，即 AdGroup。

getId

获取唯一标识此广告组的 ID。

类型	说明
string	唯一标识此广告组的 ID。

getName

获取此广告组的名称。

类型	说明
string	此广告组的名称。

getStartDate

获取此广告组中的广告开始投放的日期。

类型	说明
BingAdsDate	此广告组中的广告开始投放的日期。

getStats

获取此广告组的效果数据。

要调用此方法，您必须在广告组选择器的链中包含其中一个forDateRange方法。

类型	说明
统计	此广告组的性能数据。

isEnabled

获取指示是否启用此广告组的布尔值。

类型	说明
Boolean	如果启用此广告组，则为 true ;否则为 false。

isPaused

获取指示此广告组是否已暂停的布尔值。

类型	说明
Boolean	如果此广告组已暂停，则为 true ;否则为 false。

isRemoved

获取一个布尔值，指示此广告组是被删除 (删除) 。

类型	说明
Boolean	如果删除此广告组，则为 true ;否则为 false。

keywords

获取用于筛选此广告组中关键字列表的选择器。

类型	说明
KeywordSelector	用于筛选此广告组中关键字列表的选择器。

类型	说明
LabelSelector	用于筛选与此广告组关联的标签列表的选择器。

newAd

获取包含用于获取广告生成器的方法的对象。

类型	说明
AdBuilderSpace	包含用于获取广告生成器的方法的对象。例如，要构建加大型文本广告，请调用对象的方法 `expandedTextAdBuilder` 以获取 ExpandedTextAdBuilder 对象。

newKeywordBuilder

获取用于向此广告组添加关键字 (keyword) 的生成器。

类型	说明
KeywordBuilder	用于向此广告组添加关键字 (keyword) 的生成器。

暂停

暂停此广告组。

类型	说明
void	不返回任何内容。

productGroups

获取用于筛选此广告组中产品组列表的选择器。

类型	说明
ProductGroupSelector	用于筛选此广告组中产品组列表的选择器。

removeLabel (字符串名称)

从广告组中删除标签。

参数

名称	类型	说明
name	string	标签的名称（区分大小写）。要获取与此广告组关联的标签列表，请参阅标签。

类型	说明
void	不返回任何内容。

rootProductGroup

获取此广告组中的根产品组。

类型	说明
ProductGroup	此广告组中的根产品组。如果广告组不包含产品组，则返回 null。

setEndDate (字符串 endDate)

设置此广告组中的广告停止投放的日期。仅当您希望组中的广告在特定日期停止投放时，才设置结束日期。

参数

名称	类型	说明
endDate	string	广告组中的广告停止投放的日期。以 YYYYMMDD 格式指定日期。

类型	说明
void	不返回任何内容。

setEndDate (对象 endDate)