这是用于访问和管理单个帐户的顶级对象。
注意
此对象替换 BingAdsApp 对象。 在不久的将来,脚本将继续支持 BingAdsApp 以实现向后兼容性;但是,建议你更新脚本,以便尽早使用此对象。
方法
| 方法名称 | 返回类型 | 说明 |
|---|---|---|
| adGroups | AdGroupSelector | 获取一个 选择器 ,用于筛选此帐户中的广告组列表。 |
| 广告 | AdSelector | 获取用于筛选此帐户中的广告列表 的选择器 。 |
| 预算 | BudgetSelector | 获取用于筛选此帐户中共享预算列表 的选择器 。 |
| 活动 | CampaignSelector | 获取一个选择器,用于筛选此帐户中的市场活动列表。 |
| createLabel (字符串名称、字符串说明、字符串 backgroundColor) | void | 创建一个连接符。 |
| currentAccount | Account | 获取脚本当前正在处理的帐户。 |
| getExecutionInfo | ExecutionInfo | 返回有关脚本当前正在执行的环境的信息。 |
| 关键字 | KeywordSelector | 获取用于筛选此帐户中的关键字列表的选择器。 |
| 标签 | LabelSelector | 获取用于筛选此帐户中的标签列表 的选择器 。 |
| negativeKeywordLists | NegativeKeywordListSelector | 获取用于筛选此帐户中负关键字 (keyword) 列表的列表选择器。 |
| newNegativeKeywordListBuilder | NegativeKeywordListBuilder | 获取用于向此帐户添加负关键字 (keyword) 列表的生成器。 |
| performanceMaxCampaigns | CampaignSelector | 获取一个选择器,用于筛选此帐户中性能最高市场活动的列表。 |
| productGroups | ProductGroupSelector | 获取用于筛选此帐户中产品组列表的选择器。 |
| shoppingAdGroups | AdGroupSelector | 获取用于筛选此帐户中用于购物的广告组列表的选择器。 |
| shoppingCampaigns | CampaignSelector | 获取一个选择器,用于筛选此帐户中用于购物的市场活动列表。 |
| userLists | UserListSelector | 获取用于筛选此帐户中用户列表列表的选择器。 |
adGroups
获取一个 选择器 ,用于筛选此帐户中的广告组列表。
返回
| 类型 | 说明 |
|---|---|
| AdGroupSelector | 用于筛选当前帐户中的广告组列表选择器。 |
广告
获取用于筛选此帐户中的广告列表 的选择器 。
返回
| 类型 | 说明 |
|---|---|
| AdSelector | 用于筛选当前帐户中广告列表的选择器。 |
预算
获取用于筛选此帐户中共享预算列表 的选择器 。
此方法仅返回共享预算。 若要获取未共享 (单个市场活动) 预算,请调用特定市场活动的 getBudget 方法。 如果 isExplicitlyShared 方法返回 false,则不会共享市场活动的预算。
返回
| 类型 | 说明 |
|---|---|
| BudgetSelector | 用于筛选当前帐户中共享预算列表的选择器。 |
活动
获取一个 选择器 ,用于筛选此帐户中的市场活动列表。
返回
| 类型 | 说明 |
|---|---|
| CampaignSelector | 用于筛选当前帐户中的市场活动列表选择器。 |
createLabel (字符串名称、字符串说明、字符串 backgroundColor)
创建一个连接符。
有关每个帐户可创建的标签数的限制,请参阅 限制。 有关向帐户添加标签的示例,请参阅 使用标签。
参数
| 名称 | 类型 | 说明 |
|---|---|---|
| backgroundColor | string | 可选。 在标签的 UX 中使用的背景色。 可以使用以下方法指定颜色:
|
| description | string | 可选。 描述标签用法的说明。 最大大小为 200 个字符。 如果指定 backgroundColor,则必须提供说明或空字符串 (“”) 。 |
| name | string | 必填。 标签的名称。 该名称区分大小写,在帐户中必须唯一。 最大大小为 80 个字符。 方法从名称中剪裁前导空格和尾随空格。 |
返回
| 类型 | 说明 |
|---|---|
| void | 不返回任何内容。 |
currentAccount
获取脚本当前正在处理的帐户。
注意
若要在多帐户方案中使用此方法,请先选择要管理的帐户。 如果在选择帐户之前调用此方法,则调用将返回 null。
返回
| 类型 | 说明 |
|---|---|
| Account | 脚本当前正在处理的帐户。 若要了解如何在多帐户方案中使用它,请参阅 AccountsApp 的 select 方法。 |
getExecutionInfo
返回有关脚本当前正在执行的环境的信息。
返回:
| 类型 | 说明 |
|---|---|
| ExecutionInfo | 有关当前正在执行脚本的环境的信息。 |
keywords
获取用于筛选此帐户中的关键字列表 的选择器 。
返回
| 类型 | 说明 |
|---|---|
| KeywordSelector | 用于筛选当前帐户中关键字列表的选择器。 |
标签
获取用于筛选此帐户中的标签列表 的选择器 。
返回
| 类型 | 说明 |
|---|---|
| LabelSelector | 用于筛选当前帐户中的标签列表的选择器。 |
negativeKeywordLists
获取用于筛选此帐户中负关键字 (keyword) 列表的列表选择器。
返回
| 类型 | 说明 |
|---|---|
| NegativeKeywordListSelector | 用于筛选当前帐户中负关键字 (keyword) 列表的列表选择器。 |
newNegativeKeywordListBuilder
获取用于向此帐户添加负关键字 (keyword) 列表的生成器。
返回
| 类型 | 说明 |
|---|---|
| NegativeKeywordListBuilder | 用于向当前帐户添加负关键字 (keyword) 列表的生成器。 |
performanceMaxCampaigns
获取一个 选择器 ,用于筛选此帐户中用于最高性能的活动列表。
返回
| 类型 | 说明 |
|---|---|
| CampaignSelector | 一个选择器,用于筛选当前帐户中用于最高性能的活动列表。 |
productGroups
获取用于筛选此帐户中产品组列表 的选择器 。
返回
| 类型 | 说明 |
|---|---|
| ProductGroupSelector | 用于筛选当前帐户中产品组列表的选择器。 |
shoppingAdGroups
获取用于筛选此帐户中用于购物的广告组列表 的选择器 。
返回
| 类型 | 说明 |
|---|---|
| AdGroupSelector | 用于筛选当前帐户中用于购物的广告组列表的选择器。 |
shoppingCampaigns
获取一个 选择器 ,用于筛选此帐户中用于购物的市场活动列表。
返回
| 类型 | 说明 |
|---|---|
| CampaignSelector | 用于筛选当前帐户中用于购物的市场活动列表的选择器。 |
userLists
获取用于筛选此帐户中用户列表列表 的选择器 。
返回
| 类型 | 说明 |
|---|---|
| UserListSelector | 用于筛选当前帐户中用户列表列表的选择器。 |