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 脚本当前正在处理的帐户。 要了解如何在多帐户场景下使用它,请参阅 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 用于筛选当前帐户中的用户列表的选择器。

另请参阅

单一帐户访问