AdGroup

發行項
11/13/2024

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

方法

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

addLocation (int locationId)

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

傳回

類型	說明
TargetedLocationOperation	用來檢查是否已成功新增目標位置的工作物件。

addLocation (int locationId， double bidModifier)

從位置識別碼和標價修飾詞，在此廣告群組中建立位置目標。

傳回

類型	說明
TargetedLocationOperation	用來檢查是否已成功新增目標位置的工作物件。

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

applyLabel (字串名稱)

將標籤套用至廣告群組。

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

引數

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

傳回

類型	說明
void	會傳回 nothing。

投標

取得用來管理此廣告群組的報價金額的方法。

傳回：

類型	說明
AdGroupBidding	包含管理此廣告群組的報價金額的方法。

使

啟用此廣告群組。

傳回

類型	說明
void	會傳回 nothing。

excludeLocation (int locationId)

從位置識別碼建立此廣告群組中的位置排除。

傳回

類型	說明
ExcludedLocationOperation	用來檢查是否已成功新增排除位置的工作物件。

getCampaign

取得此廣告群組所屬的行銷活動。

傳回

類型	說明
行銷活動	此廣告群組所屬的行銷活動。

getEndDate

取得此廣告群組中的廣告停止供應的日期。

傳回

類型	說明
BingAdsDate	此廣告群組中的廣告停止供應的日期。

getEntityType

取得這個實體的類型。

傳回

類型	描述
字串	此實體的類型，也就是 AdGroup。

getId

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

傳回

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

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

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

傳回

類型	說明
ProductGroup	此廣告群組中的根產品群組。如果廣告群組不包含產品群組，則傳回 Null。

setEndDate (字串 endDate)

設定此廣告群組中的廣告停止供應的日期。只有當您想要群組中的廣告在特定日期停止供應時，才設定結束日期。

引數

名稱	類型	說明
endDate	字串	廣告群組中的廣告停止供應的日期。以 YYYYMMDD 格式指定日期。

傳回

類型	說明
void	會傳回 nothing。

setEndDate (Object endDate)