AdsApp

文章
12/21/2023

這是用來存取和管理單一帳戶的最上層物件。

注意事項

此物件會取代 BingAdsApp 物件。在不久的將來，腳本將繼續支援 BingAdsApp 以獲得回溯相容性;不過，建議您更新腳本，以儘早使用此物件。

方法

方法名稱	傳回類型	說明
adGroups	AdGroupSelector	取得選取器，用來篩選此帳戶中的廣告群組清單。
廣告	AdSelector	取得選取器，用來篩選此帳戶中的廣告清單。
預算	BudgetSelector	取得選取器，用來篩選此帳戶中的共用預算清單。
活動	CampaignSelector	取得選取器，用來篩選此帳戶中的行銷活動清單。
createLabel (字串名稱、字串描述、字串 backgroundColor)	void	建立標籤。
currentAccount	Account	取得腳本目前正在處理的帳戶。
getExecutionInfo	ExecutionInfo	傳回腳本目前正在執行之環境的相關資訊。
關鍵字	KeywordSelector	取得選取器，用來篩選此帳戶中的關鍵字清單。
標籤	LabelSelector	取得選取器，用來篩選此帳戶中的標籤清單。
negativeKeywordLists	NegativeKeywordListSelector	取得選取器，用來篩選此帳戶中負關鍵字清單的清單。
newNegativeKeywordListBuilder	NegativeKeywordListBuilder	取得建立器，用來將負關鍵字清單新增至此帳戶。
productGroups	ProductGroupSelector	取得選取器，用來篩選此帳戶中的產品群組清單。
shoppingAdGroups	AdGroupSelector	取得選取器，用來篩選此帳戶中用於購物的廣告群組清單。
shoppingCampaigns	CampaignSelector	取得選取器，用來篩選此帳戶中用於購物的活動清單。
userLists	UserListSelector	取得選取器，用來篩選此帳戶中的使用者清單。

adGroups

取得選取器，用來篩選此帳戶中的廣告群組清單。

傳回

類型	說明
AdGroupSelector	用來篩選目前帳戶中廣告群組清單的選取器。

類型	說明
AdSelector	用來篩選目前帳戶中廣告清單的選取器。

預算

取得選取器，用來篩選此帳戶中的共用預算清單。

這個方法只會傳回共用預算。若要取得未共用 (個別行銷活動) 預算，請呼叫特定行銷活動的 getBudget 方法。如果 isExplicitlyShared 方法傳回 false，則不會共用行銷活動的預算。

傳回

類型	說明
BudgetSelector	用來篩選目前帳戶中共用預算清單的選取器。

活動

取得選取器，用來篩選此帳戶中的行銷活動清單。

傳回

類型	說明
CampaignSelector	選取器，用來篩選目前帳戶中的行銷活動清單。

createLabel (字串名稱、字串描述、字串 backgroundColor)

建立標籤。

如需每個帳戶可能建立的標籤數目限制，請參閱限制。如需將標籤新增至帳戶的範例，請參閱使用標籤。

引數

名稱	類型	說明
backgroundColor	字串	選用。要在 UX 中用於標籤的背景色彩。您可以使用下列專案來指定色彩：表單中的三位元組十六進位數位，#RRGGBB。例如，#CB0400。 16 個已知 CSS 色彩名稱的其中一個。例如，青色、黃色和模糊。選擇色彩時，請考慮可存取性。如果未指定，則會為您選擇隨機色彩。
描述	string	選用。描述標籤用途的描述。大小上限為 200 個字元。如果您指定 `backgroundColor` ，則必須提供描述或空字串 (「」) 。
name	string	此為必要動作。標籤的名稱。名稱會區分大小寫，而且在帳戶內必須是唯一的。大小上限為 80 個字元。方法會從名稱修剪開頭和尾端空白字元。

傳回

類型	說明
void	會傳回 nothing。

currentAccount

取得腳本目前正在處理的帳戶。

注意事項

若要在多重帳戶案例中使用此方法，請先選取要管理的帳戶。如果您在選取帳戶之前呼叫此方法，則呼叫會傳回 Null。

傳回

類型	說明
Account	腳本目前正在處理的帳戶。若要瞭解如何在多重帳戶案例中使用此功能，請參閱AccountsApp的select方法。

getExecutionInfo

傳回腳本目前正在執行之環境的相關資訊。

傳回：

類型	說明
ExecutionInfo	腳本目前正在執行之環境的相關資訊。

關鍵字

取得選取器，用來篩選此帳戶中的關鍵字清單。

傳回

類型	說明
KeywordSelector	用來篩選目前帳戶中關鍵字清單的選取器。

類型	說明
LabelSelector	用來篩選目前帳戶中標籤清單的選取器。

negativeKeywordLists

取得選取器，用來篩選此帳戶中負關鍵字清單的清單。

傳回

類型	說明
NegativeKeywordListSelector	用來篩選目前帳戶中負關鍵字清單的選取器。

newNegativeKeywordListBuilder

取得建立器，用來將負關鍵字清單新增至此帳戶。

傳回

類型	說明
NegativeKeywordListBuilder	用來將負關鍵字清單新增至目前帳戶的產生器。

productGroups

取得選取器，用來篩選此帳戶中的產品群組清單。

傳回

類型	說明
ProductGroupSelector	用來篩選目前帳戶中產品群組清單的選取器。

shoppingAdGroups

取得選取器，用來篩選此帳戶中用於購物的廣告群組清單。

傳回

類型	說明
AdGroupSelector	選取器，用來篩選目前帳戶中用於購物的廣告群組清單。

shoppingCampaigns

取得選取器，用來篩選此帳戶中用於購物的活動清單。

傳回

類型	說明
CampaignSelector	選取器，用來篩選目前帳戶中用於購物的活動清單。

userLists

取得選取器，用來篩選此帳戶中的使用者清單。

傳回

類型	說明
UserListSelector	用來篩選目前帳戶中使用者清單的選取器。

另請參閱

單一帳戶存取

分享方式：