AdsApp

これは、1 つのアカウントにアクセスして管理するために使用される最上位のオブジェクトです。

注:

このオブジェクトは、 BingAdsApp オブジェクトを置き換えます。 当面の間、スクリプトは下位互換性のために BingAdsApp をサポートし続けます。ただし、できるだけ早くこのオブジェクトを使用するようにスクリプトを更新することをお勧めします。

メソッド

メソッド名	戻り値の型	説明
adGroups	AdGroupSelector	このアカウント内の広告グループの一覧をフィルタリングするために使用される セレクター を取得します。
広告	AdSelector	このアカウントの広告の一覧をフィルター処理するために使用される セレクター を取得します。
予算	BudgetSelector	このアカウントの共有予算のリストをフィルター処理するために使用する セレクター を取得します。
キャンペーン	CampaignSelector	このアカウントのキャンペーンのリストをフィルター処理するために使用されるセレクターを取得します。
createLabel(string name, string description, string backgroundColor)	void	ラベルを作成します。
currentAccount	Account	スクリプトが現在処理しているアカウントを取得します。
getExecutionInfo	ExecutionInfo	スクリプトが現在実行されている環境に関する情報を返します。
keywords	KeywordSelector	このアカウント内のキーワードのリストをフィルター処理するために使用されるセレクターを取得します。
labels	LabelSelector	このアカウント内のラベルのリストをフィルター処理するために使用される セレクター を取得します。
negativeKeywordLists	NegativeKeywordListSelector	このアカウントの除外キーワード (keyword)リストのリストをフィルター処理するために使用されるセレクターを取得します。
newNegativeKeywordListBuilder	NegativeKeywordListBuilder	このアカウントに負のキーワード (keyword) リストを追加するために使用するビルダーを取得します。
performanceMaxCampaigns	CampaignSelector	このアカウントのパフォーマンス最大化キャンペーンのリストをフィルター処理するために使用されるセレクターを取得します。
productGroups	ProductGroupSelector	このアカウント内の製品グループの一覧をフィルター処理するために使用するセレクターを取得します。
shoppingAdGroups	AdGroupSelector	このアカウントでのショッピングに使用された広告グループの一覧をフィルタリングするために使用されるセレクターを取得します。
shoppingCampaigns	CampaignSelector	このアカウントでのショッピングに使用されたキャンペーンのリストをフィルタリングするために使用されるセレクターを取得します。
userLists	UserListSelector	このアカウントのユーザー リストのリストをフィルター処理するために使用するセレクターを取得します。

adGroups

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

戻り値

型	説明
AdGroupSelector	現在のアカウントの広告グループの一覧をフィルタリングするために使用されるセレクター。

広告

このアカウントの広告の一覧をフィルター処理するために使用される セレクター を取得します。

戻り値

型	説明
AdSelector	現在のアカウントの広告のリストをフィルタリングするために使用されるセレクター。

予算

このアカウントの共有予算のリストをフィルター処理するために使用する セレクター を取得します。

このメソッドは共有予算のみを返します。 共有されていない (個々のキャンペーンの) 予算を取得するには、特定のキャンペーンの getBudget メソッドを呼び出します。 isExplicitlyShared メソッドが false を返した場合、キャンペーンの予算は共有されません。

戻り値

型	説明
BudgetSelector	当座用アカウントの共有予算のリストをフィルター処理するために使用されるセレクター。

キャンペーン

このアカウントのキャンペーンのリストをフィルター処理するために使用される セレクター を取得します。

戻り値

型	説明
CampaignSelector	現在のアカウントのキャンペーンのリストをフィルター処理するために使用されるセレクター。

createLabel(string name, string description, string backgroundColor)

ラベルを作成します。

アカウントごとに作成できるラベルの数の制限については、「 制限」を参照してください。 アカウントにラベルを追加する例については、「 ラベルの使用」を参照してください。

引数

名前	型	説明
backgroundColor	string	省略可能。 ラベルの UX で使用する背景色。 色は次のように指定できます。 #RRGGBB という形式の 3 バイトの 16 進数。 たとえば、#CB0400。 既知の 16 個の CSS カラー名の 1 つ。 たとえば、アクア、イエロー、フクシアなどです。 色を選択するときは、アクセシビリティを考慮してください。 指定しない場合は、ランダムな色が選択されます。
説明	string	省略可能。 ラベルの使用を説明する説明。 最大サイズは 200 文字です。 backgroundColor を指定する場合は、説明または空の文字列 ("") を指定する必要があります。
name	string	必須です。 ラベルの名前。 名前は大文字と小文字が区別され、アカウント内で一意である必要があります。 最大サイズは 80 文字です。 このメソッドは、名前から先頭と末尾の空白をトリミングします。

戻り値

型	説明
void	Nothing を返します。

currentAccount

スクリプトが現在処理しているアカウントを取得します。

注:

マルチアカウント シナリオでこの方法を使用するには、まず管理するアカウントを選択します。 アカウントを選択する前にこのメソッドを呼び出すと、呼び出しから null が返されます。

戻り値

型	説明
Account	スクリプトが現在処理中のアカウント。 マルチアカウント シナリオでこれを使用する方法については、AccountsAppの選択メソッドを参照してください。

getExecutionInfo

スクリプトが現在実行されている環境に関する情報を返します。

戻り値:

型	説明
ExecutionInfo	スクリプトが現在実行されている環境に関する情報。

keywords

このアカウント内のキーワードのリストをフィルター処理するために使用される セレクター を取得します。

戻り値

型	説明
KeywordSelector	現在のアカウントのキーワードのリストをフィルター処理するために使用されるセレクター。

labels

このアカウント内のラベルのリストをフィルター処理するために使用される セレクター を取得します。

戻り値

型	説明
LabelSelector	現在のアカウントのラベルのリストをフィルター処理するために使用されるセレクター。

negativeKeywordLists

このアカウントの除外キーワード (keyword)リストのリストをフィルター処理するために使用されるセレクターを取得します。

戻り値

型	説明
NegativeKeywordListSelector	現在のアカウントの除外キーワード (keyword)リストのリストをフィルター処理するために使用されるセレクター。

newNegativeKeywordListBuilder

このアカウントに負のキーワード (keyword) リストを追加するために使用するビルダーを取得します。

戻り値

型	説明
NegativeKeywordListBuilder	現在のアカウントに負のキーワード (keyword) リストを追加するために使用したビルダー。

performanceMaxCampaigns

このアカウントの Performance Max に使用されるキャンペーンのリストをフィルター処理するために使用される セレクター を取得します。

戻り値

型	説明
CampaignSelector	現在のアカウントの Performance Max に使用されるキャンペーンのリストをフィルター処理するために使用されるセレクター。

productGroups

このアカウント内の製品グループの一覧をフィルター処理するために使用する セレクター を取得します。

戻り値

型	説明
ProductGroupSelector	現在のアカウントの製品グループの一覧をフィルター処理するために使用されるセレクター。

shoppingAdGroups

このアカウントでのショッピングに使用された広告グループの一覧をフィルタリングするために使用される セレクター を取得します。

戻り値

型	説明
AdGroupSelector	現在のアカウントでのショッピングに使用される広告グループの一覧をフィルタリングするために使用されるセレクター。

shoppingCampaigns

このアカウントでのショッピングに使用されたキャンペーンのリストをフィルタリングするために使用される セレクター を取得します。

戻り値

型	説明
CampaignSelector	現在のアカウントでのショッピングに使用されるキャンペーンのリストをフィルター処理するために使用されるセレクター。

userLists

このアカウントのユーザー リストのリストをフィルター処理するために使用する セレクター を取得します。

戻り値

型	説明
UserListSelector	現在のアカウントのユーザー リストのリストをフィルター処理するために使用されるセレクター。

関連項目

シングル アカウント アクセス