AdsApp.​ShoppingAdGroupBuilder

AI-generated Key Takeaways

• The ShoppingAdGroupBuilder facilitates the creation and configuration of new shopping ad groups within Google Ads campaigns.

• Key properties like name, status (e.g., "PAUSED", "ENABLED"), and maximum CPC bid can be set using dedicated methods.

• The build() method finalizes the ad group configuration and returns a ShoppingAdGroupOperation for accessing the created ad group.

• If the ad group name is not explicitly set using withName(), a default name will be assigned.

• Similarly, the ad group status defaults to ENABLED if not specified using withStatus().

Builder for a shopping ad group under construction.

Typical usage:

var shoppingAdGroupBuilder = campaign.newAdGroupBuilder();
var shoppingAdGroupOperation = shoppingAdGroupBuilder
   .withName("shopping ad group name")
   .withStatus("PAUSED")
   .build();
var shoppingAdGroup = shoppingAdGroupOperation.getResult();

Methods:

Member	Type	Description
build()	AdsApp.ShoppingAdGroupOperation	Creates a ShoppingAdGroup.
withCpc(cpc)	AdsApp.ShoppingAdGroupBuilder	Sets the max CPC bid of the new shopping ad group to the specified value.
withName(name)	AdsApp.ShoppingAdGroupBuilder	Sets the name of the new shopping ad group to the specified value.
withStatus(status)	AdsApp.ShoppingAdGroupBuilder	Sets the status of the new shopping ad group to the specified value.

build()

Creates a ShoppingAdGroup. Returns a ShoppingAdGroupOperation that can be used to get the new shopping ad group (or access any associated errors if creation failed).

Return values:

Type	Description
AdsApp.ShoppingAdGroupOperation	The associated shopping ad group operation.

withCpc(cpc)

Sets the max CPC bid of the new shopping ad group to the specified value.

Arguments:

Name	Type	Description
cpc	double	The max CPC bid of the shopping ad group.

Return values:

Type	Description
AdsApp.ShoppingAdGroupBuilder	The shopping ad group builder with the specified max CPC.

withName(name)

Sets the name of the new shopping ad group to the specified value. If ad group name is not set, the shopping ad group will assume a default name ('Ad Group #5').

Arguments:

Name	Type	Description
name	String	Shopping ad group name.

Return values:

Type	Description
AdsApp.ShoppingAdGroupBuilder	Shopping ad group builder with the specified name.

withStatus(status)

Sets the status of the new shopping ad group to the specified value. If the status is not set, it will default to ENABLED.

Arguments:

Name	Type	Description
status	String	Ad group status.

Return values:

Type	Description
AdsApp.ShoppingAdGroupBuilder	Shopping ad group builder with the specified status.