AdGroupAudienceBuilder

広告グループの対象ユーザーの関連付けを定義および作成するためのメソッドが含まれています。 ビルダーの詳細については、「 Builders」を参照してください。

使用例:

    // 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`);
            }
        }
    }

メソッド

メソッド名	戻り値の型	説明
ビルド	AdGroupAudienceOperation	広告グループの対象ユーザーの関連付けを作成し、広告グループの対象ユーザーの関連付けが正常に追加されたかどうかを確認するために使用される操作オブジェクトを返します。
除外	AdGroupExcludedAudienceOperation	指定した対象ユーザーをこの広告グループから除外し、除外された広告グループの対象ユーザーが正常に追加されたかどうかを確認するために使用される操作オブジェクトを返します。
withAudience(Object userList)	AdGroupAudienceBuilder	関連付けられているユーザー リストを設定します。
withAudienceId(string audienceId)	AdGroupAudienceBuilder	関連付けられている対象ユーザーの ID を設定します。
withAudienceType(string audienceType)	AdGroupAudienceBuilder	関連付けられている対象ユーザーの種類を設定します。
withBidModifier(double 修飾子)	AdGroupAudienceBuilder	関連付けの入札修飾子を設定します。

ビルド

広告グループの対象ユーザーを作成し、広告グループの対象ユーザーが正常に追加されたかどうかを確認するために使用する操作オブジェクトを返します。

戻り値

型	説明
AdGroupAudienceOperation	広告グループの対象ユーザーが正常に追加されたかどうかを確認するために使用される操作オブジェクト。

除外

指定した対象ユーザーをこの広告グループから除外し、除外された広告グループの対象ユーザーが正常に追加されたかどうかを確認するために使用される操作オブジェクトを返します。

戻り値

型	説明
AdGroupExcludedAudienceOperation	除外された広告グループの対象ユーザーが正常に追加されたかどうかを確認するために使用される操作オブジェクト。

withAudience(Object userList)

関連付けられているユーザー リストを設定します。

引数

名前	型	説明
userList	string	関連付けられているユーザー リスト。

withAudienceId(string audienceId)

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

引数

名前	型	説明
audienceId	string	関連付けられている対象ユーザーの ID。

withAudienceType(string audienceType)

関連付けられている対象ユーザーの種類を設定します。

引数

名前	型	説明
audienceId	string	関連付けられている対象ユーザーの種類。

withBidModifier(double 修飾子)

関連付けの入札修飾子を設定します。

引数

名前	型	説明
修飾子	double	関連付けの入札修飾子。

戻り値

型	説明
AdGroupAudienceBuilder	入札条件が適用された広告グループのオーディエンス ビルダー。

戻り値

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