AdGroup

项目
11/13/2024

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

方法

方法名称	返回类型	说明
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	布尔值	获取一个布尔值，该值指示是否删除此广告组。
关键字	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	提供对广告组级别定位条件的访问权限：位置定位。
Url	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)