這是用來存取和管理單一帳戶的最上層物件。
注意事項
這個物件會取代 BingAdsApp 物件。 在不久的將來，指令碼將繼續支援 BingAdsApp 以提供回溯相容性;不過，我們建議您儘早更新指令碼，以便儘早使用此物件。
方法
| 方法名稱 | 傳回類型 | 描述 |
|---|---|---|
| 廣告群組 | AdGroupSelector | 取得用來篩選此帳戶中廣告群組清單的 選取器 。 |
| 廣告 | AdSelector | 取得用來篩選此帳戶中的廣告清單的 選取器 。 |
| 預算 | BudgetSelector | 取得用來篩選此帳戶中的共用預算清單的 選取器 。 |
| 廣告活動 | CampaignSelector | 取得用來篩選此帳戶中廣告活動清單的選取器。 |
| createLabel (字串名稱、字串描述、字串 backgroundColor) | void | 建立標籤。 |
| currentAccount | Account | 取得指令碼目前正在處理的帳戶。 |
| getExecutionInfo | ExecutionInfo | 傳回指令碼目前執行所在環境的相關資訊。 |
| 關鍵字 | KeywordSelector | 取得用來篩選此帳戶中關鍵字清單的選取器。 |
| 標籤 | LabelSelector | 取得用來篩選此帳戶中標籤清單的 選取器 。 |
| negativeKeywordLists | NegativeKeywordListSelector | 取得選取器，用來篩選此帳戶中的排除字彙清單。 |
| newNegativeKeywordListBuilder | NegativeKeywordListBuilder | 取得用來將排除字彙清單新增至此帳戶的建立器。 |
| performanceMaxCampaigns | CampaignSelector | 取得用來篩選此帳戶中最高成效廣告活動清單的選取器。 |
| productGroups | ProductGroupSelector | 取得用來篩選此帳戶中產品群組清單的選取器。 |
| shoppingAdGroups | AdGroupSelector | 取得用來篩選用於在此帳戶中購物的廣告群組清單的選取器。 |
| shoppingCampaigns | CampaignSelector | 取得用來篩選用於在此帳戶中購物的廣告活動清單的選取器。 |
| userLists | UserListSelector | 取得用來篩選此帳戶中使用者清單的選取器。 |
廣告群組
取得用來篩選此帳戶中廣告群組清單的 選取器 。
傳回
| 類型 | 描述 |
|---|---|
| AdGroupSelector | 用來篩選目前帳戶中廣告群組清單的選取器。 |
廣告
取得用來篩選此帳戶中的廣告清單的 選取器 。
傳回
| 類型 | 描述 |
|---|---|
| AdSelector | 用來篩選目前帳戶中的廣告清單的選取器。 |
預算
取得用來篩選此帳戶中的共用預算清單的 選取器 。
此方法只會傳回共用預算。 若要取得未共用 (個別廣告活動) 預算，請呼叫特定廣告活動的 getBudget 方法。 如果方法傳回 false，則isExplicitlyShared不會共用廣告活動的預算。
傳回
| 類型 | 描述 |
|---|---|
| BudgetSelector | 用來篩選目前帳戶中的共用預算清單的選取器。 |
廣告活動
取得用來篩選此帳戶中廣告活動清單的 選取器 。
傳回
| 類型 | 描述 |
|---|---|
| CampaignSelector | 用來篩選目前帳戶中廣告活動清單的選取器。 |
createLabel (字串名稱、字串描述、字串 backgroundColor)
建立標籤。
如需每個帳戶可建立標籤數目的限制，請參閱 限制。 如需將標籤新增至帳戶的範例，請參閱 使用標籤。
引數
| 名稱 | 類型 | 描述 |
|---|---|---|
| backgroundColor | 字串 | 選用。 要在標籤的 UX 中使用的背景色彩。 您可以使用以下方式指定色彩：
|
| 描述 | string | 選用。 描述標籤用途的描述。 最大長度為 200 個字元。 如果您指定 backgroundColor，必須提供描述或空白字串 (“”) 。 |
| name | string | 此為必要動作。 標籤的名稱。 名稱區分大小寫，且在帳戶內必須是唯一的。 最大長度為 80 個字元。 此方法會修剪名稱中的前置和後置空格。 |
傳回
| 類型 | 描述 |
|---|---|
| void | 會傳回 nothing。 |
currentAccount
取得指令碼目前正在處理的帳戶。
注意事項
若要在多帳戶案例中使用此方法，請先選取要管理的帳戶。 如果您在選取帳戶之前呼叫這個方法，則呼叫會傳回 null。
傳回
| 類型 | 描述 |
|---|---|
| Account | 指令碼目前正在處理的帳戶。 若要了解如何在多帳戶案例中使用它，請參閱 AccountsApp 的 select 方法。 |
getExecutionInfo
傳回指令碼目前執行所在環境的相關資訊。
傳回：
| 類型 | 描述 |
|---|---|
| ExecutionInfo | 指令碼目前執行所在環境的相關資訊。 |
關鍵字
取得用來篩選此帳戶中關鍵字清單的 選取器 。
傳回
| 類型 | 描述 |
|---|---|
| KeywordSelector | 用來篩選目前帳戶中關鍵字清單的選取器。 |
標籤
取得用來篩選此帳戶中標籤清單的 選取器 。
傳回
| 類型 | 描述 |
|---|---|
| LabelSelector | 用來篩選目前帳戶中標籤清單的選取器。 |
negativeKeywordLists
取得 選取器 ，用來篩選此帳戶中的排除字彙清單。
傳回
| 類型 | 描述 |
|---|---|
| NegativeKeywordListSelector | 用來篩選目前帳戶中排除字彙清單的選取器。 |
newNegativeKeywordListBuilder
取得用來將排除字彙清單新增至此帳戶的 建立器 。
傳回
| 類型 | 描述 |
|---|---|
| NegativeKeywordListBuilder | 用來將排除字彙清單新增至目前帳戶的建立器。 |
performanceMaxCampaigns
取得 選取器 ，用來篩選用於此帳戶中最高成效的廣告活動清單。
傳回
| 類型 | 描述 |
|---|---|
| CampaignSelector | 選取器，用來篩選目前帳戶中用於最高成效的廣告活動清單。 |
productGroups
取得用來篩選此帳戶中產品群組清單的 選取器 。
傳回
| 類型 | 描述 |
|---|---|
| ProductGroupSelector | 選取器，用來篩選目前帳戶中的產品群組清單。 |
shoppingAdGroups
取得用來篩選用於在此帳戶中購物的廣告群組清單的 選取器 。
傳回
| 類型 | 描述 |
|---|---|
| AdGroupSelector | 用來篩選目前帳戶中用於購物的廣告群組清單的選取器。 |
shoppingCampaigns
取得用來篩選用於在此帳戶中購物的廣告活動清單的 選取器 。
傳回
| 類型 | 描述 |
|---|---|
| CampaignSelector | 用來篩選用於在當前帳戶中購物的廣告活動清單的選取器。 |
userLists
取得用來篩選此帳戶中使用者清單的 選取器 。
傳回
| 類型 | 描述 |
|---|---|
| UserListSelector | 用來篩選目前帳戶中使用者清單清單的選取器。 |