AdsApp

这是用于访问和管理单个帐户的顶级对象。

注意

此对象替换 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 中使用的背景色。 可以使用以下方法指定颜色:
  • 表单中的三字节十六进制数字,#RRGGBB。 例如,#CB0400。
  • 16 个已知 CSS 颜色名称之一。 例如,水、黄色和紫红色。
选择颜色时,请考虑可访问性。 如果未指定,则会为你选择一种随机颜色。
description string 可选。 描述标签用法的说明。 最大大小为 200 个字符。

如果指定 backgroundColor,则必须提供说明或空字符串 (“”) 。
name string 必填。 标签的名称。 该名称区分大小写,在帐户中必须唯一。 最大大小为 80 个字符。 方法从名称中剪裁前导空格和尾随空格。

返回

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

currentAccount

获取脚本当前正在处理的帐户。

注意

若要在多帐户方案中使用此方法,请先选择要管理的帐户。 如果在选择帐户之前调用此方法,则调用将返回 null。

返回

类型 说明
Account 脚本当前正在处理的帐户。 若要了解如何在多帐户方案中使用它,请参阅 AccountsAppselect 方法。

getExecutionInfo

返回有关脚本当前正在执行的环境的信息。

返回:

类型 说明
ExecutionInfo 有关当前正在执行脚本的环境的信息。

keywords

获取用于筛选此帐户中的关键字列表 的选择器

返回

类型 说明
KeywordSelector 用于筛选当前帐户中关键字列表的选择器。

标签

获取用于筛选此帐户中的标签列表 的选择器

返回

类型 说明
LabelSelector 用于筛选当前帐户中的标签列表的选择器。

negativeKeywordLists

获取用于筛选此帐户中负关键字 (keyword) 列表的列表选择器

返回

类型 说明
NegativeKeywordListSelector 用于筛选当前帐户中负关键字 (keyword) 列表的列表选择器。

newNegativeKeywordListBuilder

获取用于向此帐户添加负关键字 (keyword) 列表的生成器

返回

类型 说明
NegativeKeywordListBuilder 用于向当前帐户添加负关键字 (keyword) 列表的生成器。

performanceMaxCampaigns

获取一个 选择器 ,用于筛选此帐户中用于最高性能的活动列表。

返回

类型 说明
CampaignSelector 一个选择器,用于筛选当前帐户中用于最高性能的活动列表。

productGroups

获取用于筛选此帐户中产品组列表 的选择器

返回

类型 说明
ProductGroupSelector 用于筛选当前帐户中产品组列表的选择器。

shoppingAdGroups

获取用于筛选此帐户中用于购物的广告组列表 的选择器

返回

类型 说明
AdGroupSelector 用于筛选当前帐户中用于购物的广告组列表的选择器。

shoppingCampaigns

获取一个 选择器 ,用于筛选此帐户中用于购物的市场活动列表。

返回

类型 说明
CampaignSelector 用于筛选当前帐户中用于购物的市场活动列表的选择器。

userLists

获取用于筛选此帐户中用户列表列表 的选择器

返回

类型 说明
UserListSelector 用于筛选当前帐户中用户列表列表的选择器。

另请参阅

单一帐户访问权限