AdsApp
這是用來存取和管理單一帳戶的最上層物件。
注意事項
此物件會取代 BingAdsApp 物件。 在不久的將來，腳本將繼續支援 BingAdsApp 以獲得回溯相容性;不過，建議您更新腳本，以儘早使用此物件。
方法
| 方法名稱 | 傳回類型 | 描述 |
|---|---|---|
| adGroups | 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 | 取得選取器，用來篩選此帳戶中的用戶清單。 |
adGroups
取得 選取器 ，用來篩選此帳戶中的廣告群組清單。
傳回
| 類型 | 描述 |
|---|---|
| AdGroupSelector | 用來篩選目前帳戶中廣告群組清單的選取器。 |
廣告
取得 選取器 ，用來篩選此帳戶中的廣告清單。
傳回
| 類型 | 描述 |
|---|---|
| AdSelector | 用來篩選目前帳戶中廣告清單的選取器。 |
預算
取得 選取器 ，用來篩選此帳戶中的共用預算清單。
這個方法只會傳回共享預算。 若要取得未共用 (個別營銷活動) 預算，請呼叫特定營銷活動的 getBudget 方法。 如果 isExplicitlyShared 方法傳回 false，則不會共用行銷活動的預算。
傳回
| 類型 | 描述 |
|---|---|
| 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 | 用來篩選目前帳戶中使用者清單的選取器。 |