这是用于访问和管理单个帐户的顶级对象。
注意
此对象替换 BingAdsApp 对象。 在不久的将来,脚本将继续支持 BingAdsApp 以实现向后兼容性;但是,建议你更新脚本,以便在方便的时候尽早使用此对象。
方法
| 方法名称 | 返回类型 | 说明 |
|---|---|---|
| adGroups | AdGroupSelector | 获取用于筛选此帐户中广告组列表的 选择器 。 |
| 广告 | AdSelector | 获取用于筛选此帐户中的广告列表的 选择器 。 |
| 预算 | BudgetSelector | 获取用于筛选此帐户中共享预算列表的 选择器 。 |
| 市场活动 | CampaignSelector | 获取用于筛选此帐户中市场活动列表的选择器。 |
| createLabel (字符串名称、字符串说明、字符串 backgroundColor) | void | 创建一个连接符。 |
| currentAccount | Account | 获取脚本当前正在处理的帐户。 |
| getExecutionInfo | ExecutionInfo | 返回有关脚本当前正在其中执行的环境的信息。 |
| keywords | 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 (字符串名称、字符串说明、string 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 | 用于筛选当前帐户中的用户列表的选择器。 |