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 (双修饰符)	AdGroupAudienceBuilder	设置关联的出价修饰符。

build

创建广告组受众并返回一个操作对象，用于检查广告组受众是否已成功添加。

返回

类型	说明
AdGroupAudienceOperation	用于检查广告组受众是否已成功添加的操作对象。

排除

从此广告组中排除指定的受众，并返回一个操作对象，用于检查是否已成功添加排除的广告组访问群体。

返回

类型	说明
AdGroupExcludedAudienceOperation	用于检查是否已成功添加排除的广告组受众的操作对象。

withAudience (Object userList)

设置关联的用户列表。

参数

名称	类型	说明
userList	string	关联的用户列表。

withAudienceId (string audienceId)

设置关联的受众 ID。

参数

名称	类型	说明
audienceId	string	关联受众的 ID。

withAudienceType (string audienceType)

设置关联的受众类型。

参数

名称	类型	说明
audienceId	string	关联的受众类型。

withBidModifier (双修饰符)

设置关联的出价修饰符。

参数

名称	类型	说明
改 性 剂	double	关联的出价修饰符。

返回

类型	说明
AdGroupAudienceBuilder	应用了出价修饰符的广告组受众生成器。

返回

类型	说明
AdGroupAudienceBuilder	应用了名称的广告组受众生成器。