廣告群組

包含用來管理廣告群組的方法。

方法

方法名稱	傳回類型	描述
addLocation (int locationId)	TargetedLocationOperation	從位置識別碼建立這個廣告群組中的位置目標。
addLocation (int locationId， double bidModifier)	TargetedLocationOperation	根據位置 ID 和出價調節係數，建立這個廣告群組中的位置目標。
廣告	AdSelector	取得用來篩選此廣告群組中廣告清單的選取器。
applyLabel (字串名稱)	void	將標籤套用至此廣告群組。
出價	AdGroupBidding	取得用來管理這個廣告群組出價金額的方法。
[啟用]	void	啟用此廣告群組。
excludeLocation (int locationId)	ExcludedLocationOperation	在這個廣告群組中建立與位置 ID 排除位置的項目。
getCampaign	行銷活動	取得這個廣告群組所屬的廣告活動。
getEndDate	BingAdsDate	取得此廣告群組中的廣告停止刊登的日期。
getEntityType	字串	取得此實體的類型。
getId	字串	取得可唯一識別此廣告群組的 ID。
getName	字串	取得這個廣告群組的名稱。
getStartDate	BingAdsDate	取得這個廣告群組中的廣告開始刊登的日期。
getStats	統計資料	取得這個廣告群組的成效資料。
isEnabled	布林值	取得布林值，指出是否已啟用這個廣告群組。
isPaused	布林值	取得布林值，指出這個廣告群組是否已暫停。
isRemoved	布林值	取得布林值，指出是否移除此廣告群組。
關鍵字	KeywordSelector	取得用來篩選此廣告群組中關鍵字清單的選取器。
標籤	LabelSelector	取得用來篩選與此廣告群組相關聯之標籤清單的選取器。
newAd	AdBuilderSpace	取得包含取得廣告建立器方法的物件。
newKeywordBuilder	KeywordBuilder	取得用來將關鍵字新增至此廣告群組的建立器。
暫停	void	暫停這個廣告群組。
productGroups	ProductGroupSelector	取得用來篩選此廣告群組中產品群組清單的選取器。
removeLabel (字串名稱)	void	移除這個廣告群組的標籤。
rootProductGroup	產品群組	取得這個廣告群組的根產品群組。
setEndDate (字串 endDate)	void	設定這個廣告群組中的廣告停止刊登的日期。
setEndDate (物件 endDate)	void	設定這個廣告群組中的廣告停止刊登的日期。
setName (字串名稱)	void	設定廣告群組的名稱。
setStartDate (字串 startDate)	void	設定此廣告群組中的廣告開始刊登的日期。
setStartDate (物件 startDate)	void	設定此廣告群組中的廣告開始刊登的日期。
目標設定	AdGroupTargeting	提供廣告群組層級目標設定條件的存取權：位置目標設定。
URL	AdGroupUrls	包含用來管理此廣告群組的最終 URL、追蹤範本和自訂參數的方法。

addLocation (int locationId)

從位置識別碼建立這個廣告群組中的位置目標。

傳回

類型	描述
TargetedLocationOperation	作業物件用來檢查目標位置是否已成功新增。

addLocation (int locationId， double bidModifier)

根據位置 ID 和出價調節係數，建立這個廣告群組中的位置目標。

傳回

類型	描述
TargetedLocationOperation	作業物件用來檢查目標位置是否已成功新增。

類型	描述
AdSelector	用來篩選此廣告群組中的廣告清單的選取器。

applyLabel (字串名稱)

將標籤套用至廣告群組。

一個廣告群組最多可以套用 50 個標籤。如需將標籤新增至實體的範例，請參閱使用標籤。

引數

名稱	類型	描述
Name	字串	標籤的區分大小寫的名稱。若要取得此帳戶中可套用的標籤清單，請參閱 AdsApp.labels。

傳回

類型	描述
void	會傳回 nothing。

出價

取得用來管理這個廣告群組出價金額的方法。

傳回：

類型	描述
AdGroupBidding	包含管理這個廣告群組出價金額的方法。

[啟用]

啟用此廣告群組。

傳回

類型	描述
void	會傳回 nothing。

excludeLocation (int locationId)

在這個廣告群組中建立與位置 ID 排除位置的項目。

傳回

類型	描述
ExcludedLocationOperation	作業物件，用來檢查是否已成功新增排除位置。

getCampaign

取得這個廣告群組所屬的廣告活動。

傳回

類型	描述
行銷活動	這個廣告群組所屬的廣告活動。

getEndDate

取得此廣告群組中的廣告停止刊登的日期。

傳回

類型	描述
BingAdsDate	這個廣告群組中的廣告停止刊登的日期。

getEntityType

取得此實體的類型。

傳回

類型	描述
字串	此實體的類型，即 AdGroup。

getId

取得可唯一識別此廣告群組的 ID。

傳回

類型	描述
字串	可唯一識別此廣告群組的 ID。

getName

取得這個廣告群組的名稱。

傳回

類型	描述
字串	這個廣告群組的名稱。

getStartDate

取得這個廣告群組中的廣告開始刊登的日期。

傳回

類型	描述
BingAdsDate	這個廣告群組中的廣告開始刊登的日期。

getStats

取得這個廣告群組的成效資料。

若要呼叫這個方法，您必須在廣告群組選取器的鏈結中包含其中一個forDateRange方法。

傳回：

類型	描述
統計資料	這個廣告群組的成效資料。

isEnabled

取得布林值，指出是否已啟用這個廣告群組。

傳回：

類型	描述
布林值	如果已啟用此廣告群組，則為 True ;否則為 false。

isPaused

取得布林值，指出這個廣告群組是否已暫停。

傳回：

類型	描述
布林值	如果此廣告群組已暫停，則為 True ;否則為 false。

isRemoved

取得布林值，指出是否已移除 (刪除) 此廣告群組。

傳回

類型	描述
布林值	如果移除此廣告群組，則為 True ;否則為 false。

關鍵字

取得用來篩選此廣告群組中關鍵字清單的選取器。

傳回

類型	描述
KeywordSelector	用來篩選此廣告群組中關鍵字清單的選取器。

類型	描述
LabelSelector	用來篩選與此廣告群組相關聯的標籤清單的選取器。

newAd

取得包含取得廣告建立器方法的物件。

傳回

類型	描述
AdBuilderSpace	包含取得廣告建立器方法的物件。例如，若要建置延展型文字廣告，請呼叫物件的方法 `expandedTextAdBuilder` 來取得 ExpandedTextAdBuilder 物件。

newKeywordBuilder

取得用來將關鍵字新增至此廣告群組的建立器。

傳回

類型	描述
KeywordBuilder	用於將關鍵字新增至此廣告群組的建立器。

暫停

暫停這個廣告群組。

傳回

類型	描述
void	會傳回 nothing。

productGroups

取得用來篩選此廣告群組中產品群組清單的選取器。

傳回

類型	描述
ProductGroupSelector	用來篩選此廣告群組中產品群組清單的選取器。

removeLabel (字串名稱)

從廣告群組移除標籤。

引數

名稱	類型	描述
Name	字串	標籤的區分大小寫的名稱。若要取得與此廣告群組相關聯的標籤清單，請參閱標籤。

傳回

類型	描述
void	會傳回 nothing。

rootProductGroup

取得這個廣告群組中的根產品群組。

傳回

類型	描述
產品群組	這個廣告群組中的根產品群組。如果廣告群組不包含產品群組，則傳回 null。

setEndDate (字串 endDate)

設定這個廣告群組中的廣告停止刊登的日期。只在群組中的廣告在特定日期停止刊登時，才設定結束日期。

引數

名稱	類型	描述
endDate	字串	廣告群組中的廣告停止刊登的日期。在 YYYYMMDD 表單中指定日期。

傳回

類型	描述
void	會傳回 nothing。

setEndDate (物件 endDate)