AdGroup

広告グループの管理に使う方法を含みます。

メソッド

メソッド名 戻り値の型 説明
addLocation(int locationId) TargetedLocationOperation 地域 ID からこの広告グループ内の地域ターゲットを作成します。
addLocation(int locationId, double bidModifier) TargetedLocationOperation 地域 ID と入札単価調整子から、この広告グループ内の地域ターゲットを作成します。
広告 AdSelector この広告グループ内の広告のリストをフィルター処理するために使用される セレクター を取得します。
applyLabel(string name) void この広告グループにラベルを適用します。
入札 AdGroupBidding この広告グループの入札額を管理するために使用する方法を取得します。
enable void この広告グループを有効にします。
excludeLocation(int locationId) ExcludedLocationOperation この広告グループに地域 ID から地域除外を作成します。
getCampaign Campaign この広告グループが属するキャンペーンを取得します。
getEndDate BingAdsDate この広告グループ内の広告の配信が終了する日付を取得します。
getEntityType string このエンティティの型を取得します。
getId string この広告グループを一意に識別する ID を取得します。
getName string この広告グループの名前を取得します。
getStartDate BingAdsDate この広告グループの広告の配信が開始される日付を取得します。
getStats 統計情報 この広告グループのパフォーマンス データを取得します。
isEnabled ブール型 この広告グループが有効かどうかを示すブール値を取得します。
isPaused ブール型 この広告グループが一時停止しているかどうかを示すブール値を取得します。
isRemoved ブール型 この広告グループが削除されるかどうかを示すブール値を取得します。
keywords KeywordSelector この広告グループ内のキーワードのリストをフィルタリングするために使用される セレクター を取得します。
labels LabelSelector この広告グループに関連付けられているラベルのリストをフィルタリングするために使用する セレクター を取得します。
newAd AdBuilderSpace 広告ビルダーを取得するためのメソッドを含むオブジェクトを取得します。
newKeywordBuilder KeywordBuilder この広告グループにキーワード (keyword)追加するために使用されるビルダーを取得します。
一時停止 void この広告グループを一時停止します。
productGroups ProductGroupSelector この広告グループ内の商品グループのリストをフィルタリングするために使用されるセレクターを取得します。
removeLabel(string name) void この広告グループからラベルを削除します。
rootProductGroup ProductGroup この広告グループのルート商品グループを取得します。
setEndDate(string, endDate) void この広告グループの広告の配信が終了する日付を設定します。
setEndDate(Object endDate) void この広告グループの広告の配信が終了する日付を設定します。
setName(String name) void 広告グループの名前を設定します。
setStartDate(string startDate) void この広告グループの広告の配信が開始される日付を設定します。
setStartDate(Object startDate) void この広告グループの広告の配信が開始される日付を設定します。
ターゲティング AdGroupTargeting 広告グループ レベルのターゲティング条件 (地域ターゲティング) へのアクセスを提供します。
urls AdGroupUrls この広告グループの最終ページ URL、トラッキング テンプレート、カスタム パラメーターを管理するために使用される方法が含まれます。

addLocation(int locationId)

地域 ID からこの広告グループ内の地域ターゲットを作成します。

戻り値

説明
TargetedLocationOperation ターゲット地域が正常に追加されたかどうかをチェックするために使用される操作オブジェクト。

addLocation(int locationId, double bidModifier)

地域 ID と入札単価調整子から、この広告グループ内の地域ターゲットを作成します。

戻り値

説明
TargetedLocationOperation ターゲット地域が正常に追加されたかどうかをチェックするために使用される操作オブジェクト。

広告

この広告グループ内の広告のリストをフィルター処理するために使用される セレクター を取得します。

戻り値

説明
AdSelector この広告グループ内の広告のリストをフィルター処理するために使用されるセレクター。

applyLabel(string name)

広告グループにラベルを適用します。

1 つの広告グループに最大 50 個のラベルを適用できます。 エンティティにラベルを追加する例については、「 ラベルの使用」を参照してください。

引数

名前 説明
name string ラベルの大文字と小文字を区別する名前。 適用できるこのアカウントのラベルの一覧を取得するには、 AdsApp.labels を参照してください。

戻り値

説明
void Nothing を返します。

入札

この広告グループの入札額を管理するために使用する方法を取得します。

戻り値:

説明
AdGroupBidding この広告グループの入札額を管理する方法が含まれます。

enable

この広告グループを有効にします。

戻り値

説明
void Nothing を返します。

excludeLocation(int locationId)

この広告グループに地域 ID から地域除外を作成します。

戻り値

説明
ExcludedLocationOperation 除外された場所が正常に追加されたかどうかをチェックするために使用される操作オブジェクト。

getCampaign

この広告グループが属するキャンペーンを取得します。

戻り値

説明
Campaign この広告グループが属しているキャンペーン。

getEndDate

この広告グループ内の広告の配信が終了する日付を取得します。

戻り値

説明
BingAdsDate この広告グループ内の広告の配信が終了する日付。

getEntityType

このエンティティの型を取得します。

戻り値

説明
string このエンティティの種類は AdGroup です。

getId

この広告グループを一意に識別する ID を取得します。

戻り値

説明
string 広告グループを一意に識別する ID。

getName

この広告グループの名前を取得します。

戻り値

説明
string この広告グループの名前。

getStartDate

この広告グループの広告の配信が開始される日付を取得します。

戻り値

説明
BingAdsDate この広告グループ内の広告の配信が開始される日付。

getStats

この広告グループのパフォーマンス データを取得します。

このメソッドを呼び出すには、広告グループ セレクターのチェーンにいずれかのforDateRangeメソッドを含める必要があります。

戻り値:

説明
統計情報 この広告グループのパフォーマンス データ。

isEnabled

この広告グループが有効かどうかを示すブール値を取得します。

戻り値:

説明
ブール型 この広告グループが有効な場合は true 。それ以外の場合は false

isPaused

この広告グループが一時停止しているかどうかを示すブール値を取得します。

戻り値:

説明
ブール型 この広告グループが一時停止されている場合は true 。それ以外の場合は false

isRemoved

この広告グループが削除 (削除) されるかどうかを示すブール値を取得します。

戻り値

説明
ブール型 この広告グループが削除された場合は true 。それ以外の場合は false

keywords

この広告グループ内のキーワードのリストをフィルタリングするために使用される セレクター を取得します。

戻り値

説明
KeywordSelector この広告グループ内のキーワードのリストをフィルタリングするために使用されるセレクター。

labels

この広告グループに関連付けられているラベルのリストをフィルタリングするために使用する セレクター を取得します。

戻り値

説明
LabelSelector この広告グループに関連付けられているラベルのリストをフィルタリングするために使用されるセレクター。

newAd

広告ビルダーを取得するためのメソッドを含むオブジェクトを取得します。

戻り値

説明
AdBuilderSpace 広告ビルダーを取得するメソッドを含むオブジェクト。 たとえば、拡張テキスト広告を作成するには、オブジェクトの expandedTextAdBuilder メソッドを呼び出して ExpandedTextAdBuilder オブジェクトを取得します。

newKeywordBuilder

この広告グループにキーワード (keyword)追加するために使用されるビルダーを取得します。

戻り値

説明
KeywordBuilder この広告グループに キーワード (keyword) を追加するために使用したビルダー。

一時停止

この広告グループを一時停止します。

戻り値

説明
void Nothing を返します。

productGroups

この広告グループ内の商品グループのリストをフィルタリングするために使用される セレクター を取得します。

戻り値

説明
ProductGroupSelector この広告グループ内の商品グループの一覧をフィルタリングするために使用されるセレクター。

removeLabel(string name)

広告グループからラベルを削除します。

引数

名前 説明
name string ラベルの大文字と小文字を区別する名前。 この広告グループに関連付けられているラベルの一覧を取得するには、「 ラベル」を参照してください。

戻り値

説明
void Nothing を返します。

rootProductGroup

この広告グループのルート商品グループを取得します。

戻り値

説明
ProductGroup この広告グループのルート商品グループ。 広告グループに商品グループが含まれていない場合は null を返します。

setEndDate(string, endDate)

この広告グループの広告の配信が終了する日付を設定します。 グループ内の広告が特定の日に配信を停止する場合にのみ、終了日を設定します。

引数

名前 説明
endDate string 広告グループ内の広告の配信が終了する日付。 フォーム YYYYMMDD で日付を指定します。

戻り値

説明
void Nothing を返します。

setEndDate(Object endDate)

この広告グループの広告の配信が終了する日付を設定します。 グループ内の広告が特定の日に配信を停止する場合にのみ、終了日を設定します。

引数

名前 説明
endDate オブジェクト この広告グループ内の広告の配信が終了する日付。 次のフィールドを持つオブジェクトを使用して日付を指定します。
  • year
  • month
  • day
例: var date = {year: 2018, month: 5, day: 13};

月は 1 ベースで、1 は 1 月、12 は 12 月です。

戻り値

説明
void Nothing を返します。

setName(string name)

この広告グループの名前を設定します。

引数

名前 説明
name string この広告グループの名前。 名前は最大 256 文字で、キャンペーン内のすべての広告グループの中で一意である必要があります。

戻り値

説明
void Nothing を返します。

setStartDate(string startDate)

この広告グループの広告の配信が開始される日付を設定します。 グループ内の広告が特定の日に配信を開始する場合にのみ、開始日を設定します。それ以外の場合は、すぐにサービスを開始します。

引数

名前 説明
endDate string この広告グループ内の広告の配信が開始される日付。 フォーム YYYYMMDD で日付を指定します。

戻り値

説明
void Nothing を返します。

setStartDate(Object startDate)

この広告グループの広告の配信が開始される日付を設定します。 グループ内の広告が特定の日に配信を開始する場合にのみ、開始日を設定します。それ以外の場合は、すぐにサービスを開始します。

引数

名前 説明
endDate オブジェクト この広告グループ内の広告の配信が開始される日付。 次のフィールドを持つオブジェクトを使用して日付を指定します。
  • year
  • month
  • day
例: var date = {year: 2018, month: 5, day: 13};

月は 1 ベースで、1 は 1 月、12 は 12 月です。

戻り値

説明
void Nothing を返します。

ターゲティング

広告グループ レベルのターゲティング条件 (地域ターゲティング) へのアクセスを提供します。

戻り値

説明
AdGroupTargeting この広告グループ内の地域ターゲティング条件へのアクセス。

urls

この広告グループの最終ページ URL、トラッキング テンプレート、カスタム パラメーターを管理するために使用される方法が含まれます。

戻り値

説明
AdGroupUrls この広告グループの最終ページ URL、トラッキング テンプレート、カスタム パラメーターを管理するために使用されるオブジェクト。

関連項目