AdsApp

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

注意

此对象替换 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 中使用的背景色。 可使用以下方式指定颜色:
  • #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 用于筛选当前帐户中的用户列表的选择器。

另请参阅

单一帐户访问