包含用來定義和新增廣告群組的方法。 如需建置器的相關資訊，請參閱 建置器。
使用範例：
// Get a campaign to add the ad group to.
var iterator = AdsApp.campaigns()
.withIds(['CAMPAIGN ID GOES HERE'])
.get();
while (iterator.hasNext()) {
var campaign = iterator.next();
// Get the campaign's ad group builder and add an ad group.
var operation = campaign.newAdGroupBuilder()
.withName("AD GROUP NAME GOES HERE")
.withStatus("ENABLED")
.build();
// See the Builders topic for performance considerations
// when using the operation object's methods.
if (!operation.isSuccessful()) {
for (var error of operation.getErrors()) {
Logger.log(`${error}\n`);
}
}
}
方法
組建
建立廣告群組，並傳回用來檢查廣告群組是否已成功新增的作業物件。
傳回
withBiddingStrategy (字串 biddingStrategy)
設定廣告群組的出價策略。
引數
| 名稱 |
類型 |
描述 |
| biddingStrategy |
字串 |
要套用至廣告群組的出價策略。 以下是可能的區分大小寫的值。- MANUAL_CPC
- MANUAL_CPM
- MANUAL_CPV
如需這些策略的相關資訊，請參閱 出價策略類型。 |
傳回
withCpc (雙倍每次點選成本)
設定廣告群組的每次點選成本出價。
指定當關鍵字符合使用者的搜尋字詞，且廣告群組的出價策略MANUAL_CPC時要使用的出價金額。 如果較低層級的實體 （例如關鍵字） 未覆寫它，則會使用此出價。
引數
| 名稱 |
類型 |
描述 |
| 每次點選成本 |
double |
廣告群組的最高每次點選成本出價。 最低和最高出價值會由帳戶貨幣決定。 如需詳細資訊，請參閱 出價和預算貨幣。 |
傳回
withCpm (雙倍 CPM)
設定廣告群組的 CPM 出價。
指定每 1,000 次已檢視曝光數與廣告群組出價策略MANUAL_CPM時要使用的出價金額。
引數
| 名稱 |
類型 |
描述 |
| CPM |
double |
廣告群組的最高 CPM 出價。 最低和最高出價值會由帳戶貨幣決定。 如需詳細資訊，請參閱 出價和預算貨幣。 |
傳回
withCpv (雙倍每次觀看成本)
設定廣告群組的每次觀看成本出價。
指定要在影片廣告上每次觀看或每次點選時，以及當廣告群組的出價策略MANUAL_CPV時所使用的出價金額。
引數
| 名稱 |
類型 |
描述 |
| 每次觀看成本 |
double |
廣告群組的最高每次觀看成本出價。 最低和最高出價值會由帳戶貨幣決定。 如需詳細資訊，請參閱 出價和預算貨幣。 |
傳回
withCustomParameters (物件 customParameters)
設定廣告群組的自訂參數，以在最終 URL 或追蹤範本中使用。
自訂參數有助於跨多個 URL 共用動態資訊。 如需其使用方式的詳細資訊，請參閱 自訂參數。
引數
| 名稱 |
類型 |
描述 |
| customParameters |
物件 |
最多要套用至廣告群組的三個自訂參數的對應。 例如， {key1: 'value1', key2: 'value2', key3: 'value3'}其中 key 是自訂參數的名稱，而 value 是參數的值。 名稱最多可包含 16 個 8 位元組字元，而值最多可包含 200 個 8 位元組字元。 |
傳回
withEndDate (字串 endDate)
設定廣告群組中的廣告停止刊登的日期。 只有在您想要群組中的廣告在特定日期停止刊登時，才呼叫這個方法。
引數
| 名稱 |
類型 |
描述 |
| endDate |
字串 |
停止刊登廣告的日期。 在 YYYYMMDD 表單中指定日期。 |
傳回
withEndDate (物件 endDate)
設定廣告群組中的廣告停止刊登的日期。 只有在您想要群組中的廣告在特定日期停止刊登時，才呼叫這個方法。
引數
| 名稱 |
類型 |
描述 |
| endDate |
物件 |
停止刊登廣告的日期。 使用具有下列欄位的物件指定日期：
例如：var date = {year: 2018, month: 5, day: 13};
月份為以一為基礎，其中 1 是 1 月，12 為 12 月。 |
傳回
withLanguage (字串語言)
設定此廣告群組中的廣告所使用的語言。
根據預設，廣告群組會繼承其上層廣告活動的語言。 在廣告群組層級指定語言，以覆寫在廣告活動層級指定的語言，或如果廣告活動未指定語言 (則必須在廣告活動和/或廣告群組層級) 指定語言。
引數
| 名稱 |
類型 |
描述 |
| language |
字串 |
廣告群組中廣告使用的語言。 例如，英文。 字串不區分大小寫。 請勿使用雙字元語言代碼。 如需支援語言的清單，請參閱 廣告語言。 |
傳回
withName (字串名稱)
設定廣告群組的名稱。
引數
| 名稱 |
類型 |
描述 |
| Name |
字串 |
廣告群組的名稱。 名稱為必填欄位。 名稱最多可以包含 256 個字元，且在廣告活動的所有有效廣告群組中都必須是唯一的。 |
傳回
withStartDate (字串 startDate)
設定廣告群組中的廣告開始刊登的日期。 只有在您希望群組中的廣告在特定日期開始刊登時，才呼叫這個方法;否則，廣告會立即開始刊登。
引數
| 名稱 |
類型 |
描述 |
| endDate |
字串 |
開始刊登廣告的日期。 在 YYYYMMDD 表單中指定日期。 |
傳回
withStartDate (物件 startDate)
設定廣告群組中的廣告開始刊登的日期。 只有在您希望群組中的廣告在特定日期開始刊登時，才呼叫這個方法;否則，廣告會立即開始刊登。
引數
| 名稱 |
類型 |
描述 |
| endDate |
物件 |
開始刊登廣告的日期。 使用具有下列欄位的物件指定日期：
例如：var date = {year: 2018, month: 5, day: 13};
月份為以一為基礎，其中 1 是 1 月，12 為 12 月。 |
傳回
withStatus (字串狀態)
設定廣告群組的狀態。
引數
| 名稱 |
類型 |
描述 |
| 狀態 |
字串 |
廣告群組的狀態。 以下是可能的區分大小寫的值。
預設值為 [暫停]。 |
傳回
withTrackingTemplate (字串 trackingTemplate)
設定廣告群組的追蹤範本。
追蹤範本會與關鍵字的 FinalUrl 搭配使用，以建立廣告所使用的目的地 URL。 如需詳細資訊，請參閱 我可以使用哪些追蹤參數或 URL 參數？
引數
| 名稱 |
類型 |
描述 |
| trackingTemplate |
字串 |
要與廣告群組搭配使用的追蹤範本。 |
傳回
另請參閱
Campaign.newAdGroupBuilder ()