広告グループの管理に使う方法を含みます。
メソッド
addLocation(int locationId)
地域 ID からこの広告グループ内の地域ターゲットを作成します。
戻り値
addLocation(int locationId, double bidModifier)
地域 ID と入札単価調整子から、この広告グループ内の地域ターゲットを作成します。
戻り値
広告
この広告グループ内の広告のリストをフィルター処理するために使用される セレクター を取得します。
戻り値
| 型 |
説明 |
|
AdSelector |
この広告グループ内の広告のリストをフィルター処理するために使用されるセレクター。 |
applyLabel(string name)
広告グループにラベルを適用します。
1 つの広告グループに最大 50 個のラベルを適用できます。 エンティティにラベルを追加する例については、「 ラベルの使用」を参照してください。
引数
| 名前 |
型 |
説明 |
| name |
string |
ラベルの大文字と小文字を区別する名前。 適用できるこのアカウントのラベルの一覧を取得するには、 AdsApp.labels を参照してください。 |
戻り値
入札
この広告グループの入札額を管理するために使用する方法を取得します。
戻り値:
enable
この広告グループを有効にします。
戻り値
excludeLocation(int locationId)
この広告グループに地域 ID から地域除外を作成します。
戻り値
getCampaign
この広告グループが属するキャンペーンを取得します。
戻り値
getEndDate
この広告グループ内の広告の配信が終了する日付を取得します。
戻り値
getEntityType
このエンティティの型を取得します。
戻り値
| 型 |
説明 |
| string |
このエンティティの種類は AdGroup です。 |
getId
この広告グループを一意に識別する ID を取得します。
戻り値
| 型 |
説明 |
| string |
広告グループを一意に識別する ID。 |
getName
この広告グループの名前を取得します。
戻り値
getStartDate
この広告グループの広告の配信が開始される日付を取得します。
戻り値
getStats
この広告グループのパフォーマンス データを取得します。
このメソッドを呼び出すには、広告グループ セレクターのチェーンにいずれかのforDateRangeメソッドを含める必要があります。
戻り値:
| 型 |
説明 |
|
統計情報 |
この広告グループのパフォーマンス データ。 |
isEnabled
この広告グループが有効かどうかを示すブール値を取得します。
戻り値:
| 型 |
説明 |
| ブール型 |
この広告グループが有効な場合は true 。それ以外の場合は false。 |
isPaused
この広告グループが一時停止しているかどうかを示すブール値を取得します。
戻り値:
| 型 |
説明 |
| ブール型 |
この広告グループが一時停止されている場合は true 。それ以外の場合は false。 |
isRemoved
この広告グループが削除 (削除) されるかどうかを示すブール値を取得します。
戻り値
| 型 |
説明 |
| ブール型 |
この広告グループが削除された場合は true 。それ以外の場合は false。 |
keywords
この広告グループ内のキーワードのリストをフィルタリングするために使用される セレクター を取得します。
戻り値
labels
この広告グループに関連付けられているラベルのリストをフィルタリングするために使用する セレクター を取得します。
戻り値
| 型 |
説明 |
|
LabelSelector |
この広告グループに関連付けられているラベルのリストをフィルタリングするために使用されるセレクター。 |
newAd
広告ビルダーを取得するためのメソッドを含むオブジェクトを取得します。
戻り値
newKeywordBuilder
この広告グループにキーワード (keyword)追加するために使用されるビルダーを取得します。
戻り値
一時停止
この広告グループを一時停止します。
戻り値
productGroups
この広告グループ内の商品グループのリストをフィルタリングするために使用される セレクター を取得します。
戻り値
removeLabel(string name)
広告グループからラベルを削除します。
引数
| 名前 |
型 |
説明 |
| name |
string |
ラベルの大文字と小文字を区別する名前。 この広告グループに関連付けられているラベルの一覧を取得するには、「 ラベル」を参照してください。 |
戻り値
rootProductGroup
この広告グループのルート商品グループを取得します。
戻り値
| 型 |
説明 |
|
ProductGroup |
この広告グループのルート商品グループ。 広告グループに商品グループが含まれていない場合は null を返します。 |
setEndDate(string, endDate)
この広告グループの広告の配信が終了する日付を設定します。 グループ内の広告が特定の日に配信を停止する場合にのみ、終了日を設定します。
引数
| 名前 |
型 |
説明 |
| endDate |
string |
広告グループ内の広告の配信が終了する日付。 フォーム YYYYMMDD で日付を指定します。 |
戻り値
setEndDate(Object endDate)
この広告グループの広告の配信が終了する日付を設定します。 グループ内の広告が特定の日に配信を停止する場合にのみ、終了日を設定します。
引数
| 名前 |
型 |
説明 |
| endDate |
オブジェクト |
この広告グループ内の広告の配信が終了する日付。 次のフィールドを持つオブジェクトを使用して日付を指定します。 例: var date = {year: 2018, month: 5, day: 13};
月は 1 ベースで、1 は 1 月、12 は 12 月です。 |
戻り値
setName(string name)
この広告グループの名前を設定します。
引数
| 名前 |
型 |
説明 |
| name |
string |
この広告グループの名前。 名前は最大 256 文字で、キャンペーン内のすべての広告グループの中で一意である必要があります。 |
戻り値
setStartDate(string startDate)
この広告グループの広告の配信が開始される日付を設定します。 グループ内の広告が特定の日に配信を開始する場合にのみ、開始日を設定します。それ以外の場合は、すぐにサービスを開始します。
引数
| 名前 |
型 |
説明 |
| endDate |
string |
この広告グループ内の広告の配信が開始される日付。 フォーム YYYYMMDD で日付を指定します。 |
戻り値
setStartDate(Object startDate)
この広告グループの広告の配信が開始される日付を設定します。 グループ内の広告が特定の日に配信を開始する場合にのみ、開始日を設定します。それ以外の場合は、すぐにサービスを開始します。
引数
| 名前 |
型 |
説明 |
| endDate |
オブジェクト |
この広告グループ内の広告の配信が開始される日付。 次のフィールドを持つオブジェクトを使用して日付を指定します。 例: var date = {year: 2018, month: 5, day: 13};
月は 1 ベースで、1 は 1 月、12 は 12 月です。 |
戻り値
ターゲティング
広告グループ レベルのターゲティング条件 (地域ターゲティング) へのアクセスを提供します。
戻り値
urls
この広告グループの最終ページ URL、トラッキング テンプレート、カスタム パラメーターを管理するために使用される方法が含まれます。
戻り値
| 型 |
説明 |
|
AdGroupUrls |
この広告グループの最終ページ URL、トラッキング テンプレート、カスタム パラメーターを管理するために使用されるオブジェクト。 |
関連項目