AdGroupAudienceBuilder

広告グループ オーディエンスの関連付けを定義および作成するためのメソッドについて説明します。 ビルダーの詳細については、「 ビルダー」を参照してください。

使用例:

    // Gets the iterator that iterates all ad groups
    // in the account.
    var iterator = AdsApp.adGroups().get();

    // Loops through all ad groups in the account.
    while (iterator.hasNext()) {
        var adGroup = iterator.next();

        // Get the ad group audience's builder.
        var operation = adGroup.targeting().newUserListBuilder()
            .withAudienceId("AUDIENCE ID GOES HERE")
            .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`);
            }
        }
    }

メソッド

メソッド名	戻り値の型	説明
build	AdGroupAudienceOperation	広告グループ オーディエンスの関連付けを作成し、広告グループ オーディエンスの関連付けが正常に追加されたかどうかをチェックするために使用する操作オブジェクトを返します。
Exclude	AdGroupExcludedAudienceOperation	指定されたオーディエンスをこの広告グループから除外し、除外された広告グループのオーディエンスが正常に追加されたかどうかをチェックするために使用される操作オブジェクトを返します。
withAudience(Object userList)	AdGroupAudienceBuilder	関連付けられているユーザーの一覧を設定します。
withAudienceId(string audienceId)	AdGroupAudienceBuilder	関連付けられたオーディエンスの ID を設定します。
withAudienceType(string, audienceType)	AdGroupAudienceBuilder	関連付けられたオーディエンスのタイプを設定します。
withBidModifier(double modifier)	AdGroupAudienceBuilder	関連付けの入札単価調整子を設定します。

ビルド

広告グループ オーディエンスを作成し、広告グループ オーディエンスが正常に追加されたかどうかをチェックするために使用される操作オブジェクトを返します。

戻り値

型	説明
AdGroupAudienceOperation	広告グループ オーディエンスが正常に追加されたかどうかをチェックするために使用される操作オブジェクト。

Exclude

指定されたオーディエンスをこの広告グループから除外し、除外された広告グループのオーディエンスが正常に追加されたかどうかをチェックするために使用される操作オブジェクトを返します。

戻り値

型	説明
AdGroupExcludedAudienceOperation	除外された広告グループ オーディエンスが正常に追加されたかどうかをチェックするために使用される操作オブジェクト。

withAudience(Object userList)

関連付けられているユーザーの一覧を設定します。

引数

名前	型	説明
userList	string	関連付けられているユーザーの一覧。

withAudienceId(string audienceId)

関連付けられたオーディエンスの ID を設定します。

引数

名前	型	説明
audienceId	string	関連付けられたオーディエンスの ID。

withAudienceType(string, audienceType)

関連付けられたオーディエンスのタイプを設定します。

引数

名前	型	説明
audienceId	string	関連付けられているオーディエンスのタイプ。

withBidModifier(double modifier)

関連付けの入札単価調整子を設定します。

引数

名前	型	説明
修飾子	double	アソシエーションの入札単価調整子。

戻り値

型	説明
AdGroupAudienceBuilder	入札単価調整子が適用された広告グループ オーディエンス ビルダー。

戻り値

型	説明
AdGroupAudienceBuilder	名前が適用された広告グループ オーディエンス ビルダー。