次の方法で共有

AdsApp

  • [アーティクル]

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

注:

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

メソッド

メソッド名 戻り値の型 説明
adGroups AdGroupSelector このアカウントの広告グループの一覧をフィルター処理するために使用する セレクター を取得します。
広告 AdSelector このアカウントの広告の一覧をフィルター処理するために使用する セレクター を取得します。
予算 BudgetSelector このアカウントの共有予算の一覧をフィルター処理するために使用される セレクター を取得します。
キャンペーン CampaignSelector このアカウントのキャンペーンの一覧をフィルター処理するために使用するセレクターを取得します。
createLabel(string name, string description, string backgroundColor) void ラベルを作成します。
currentAccount Account スクリプトが現在処理しているアカウントを取得します。
getExecutionInfo ExecutionInfo スクリプトが現在実行されている環境に関する情報を返します。
キーワード KeywordSelector このアカウント内のキーワードの一覧をフィルター処理するために使用するセレクターを取得します。
ラベル 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 で使用する背景色。 色は次のように指定できます。
  • フォームの 3 バイトの 16 進数(#RRGGBB。 たとえば、#CB0400。
  • 16 の既知の CSS カラー名の 1 つ。 たとえば、アクア、イエロー、フクシアなどです。
色を選択する場合は、アクセス可能性を考慮してください。 指定しない場合は、ランダムな色が選択されます。
説明 string 省略可能。 ラベルの使用方法を説明する説明。 最大サイズは 200 文字です。

backgroundColorを指定する場合は、説明または空の文字列 ("") を指定する必要があります。
name string 必須です。 ラベルの名前。 名前は大文字と小文字が区別され、アカウント内で一意である必要があります。 最大サイズは 80 文字です。 メソッドは、名前から先頭と末尾の空白をトリミングします。

戻り値

型 説明
void Nothing を返します。

currentAccount

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

注:

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

戻り値

型 説明
Account スクリプトが現在処理しているアカウント。 複数アカウントのシナリオでこれを使用する方法については、AccountsApp の選択方法に関するページを参照してください。

getExecutionInfo

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

戻り値:

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

keywords

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

戻り値

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

ラベル

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

戻り値

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

negativeKeywordLists

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

戻り値

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

newNegativeKeywordListBuilder

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

戻り値

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

performanceMaxCampaigns

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

戻り値

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

productGroups

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

戻り値

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

shoppingAdGroups

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

戻り値

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

shoppingCampaigns

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

戻り値

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

userLists

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

戻り値

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

関連項目

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