AdsApp.​ProductCategoryBuilder

AI-generated Key Takeaways

• This page documents the ProductCategoryBuilder for creating and managing product categories in Google Ads scripts.

• ProductCategoryBuilder allows specifying the bid, name, and value for a new product category.

• The build() method finalizes the product category creation and returns a ProductCategoryOperation.

• It's crucial to specify the product category name using withName() before building, otherwise it will fail.

• You can optionally provide a language code for localizing the product category name using withName() and withValue().

Builder for ProductCategory objects.

Methods:

Member	Type	Description
build()	AdsApp.ProductCategoryOperation	Builds the product category.
withBid(bid)	AdsApp.ProductCategoryBuilder	Specifies the bid of the product category.
withName(productCategoryName)	AdsApp.ProductCategoryBuilder	Specifies the name of the new product category.
withName(productCategoryName, optionalLanguageCode)	AdsApp.ProductCategoryBuilder	Specifies the name of the new product category.
withValue(value)	AdsApp.ProductCategoryBuilder	Specifies the value of the product category.
withValue(value, optionalLanguageCode)	AdsApp.ProductCategoryBuilder

build()

Builds the product category. Returns a ProductCategoryOperation that corresponds to the creation of the ProductCategory.

Return values:

Type	Description
AdsApp.ProductCategoryOperation	The ProductCategoryOperation.

withBid(bid)

Specifies the bid of the product category. If this is unspecified, will use the bid of the parent product group.

Arguments:

Name	Type	Description
bid	double	The bid.

Return values:

Type	Description
AdsApp.ProductCategoryBuilder	The ProductCategoryBuilder with the specified bid.

withName(productCategoryName)

Specifies the name of the new product category. If the name is unspecified before calling 'build', the category will fail to build.

Arguments:

Name	Type	Description
productCategoryName	String	The name to specify for the new product category.

Return values:

Type	Description
AdsApp.ProductCategoryBuilder	Product category builder.

withName(productCategoryName, optionalLanguageCode)

Specifies the name of the new product category. If the name is unspecified before calling 'build', the category will fail to build.

Arguments:

Name	Type	Description
productCategoryName	String	The name to specify for the new product category.
optionalLanguageCode	String	Optional locale to be used for localising the product bidding category names.

Return values:

Type	Description
AdsApp.ProductCategoryBuilder	Product category builder.

withValue(value)

Specifies the value of the product category.

Arguments:

Name	Type	Description
value	String	The value.

Return values:

Type	Description
AdsApp.ProductCategoryBuilder	The ProductCategoryBuilder with the specified value.

withValue(value, optionalLanguageCode)

Arguments:

Name	Type	Description
value	String
optionalLanguageCode	String	Optional locale to be used for localising the product bidding category names. If unspecified, the language code defaults to "en-US".

Return values:

Type	Description
AdsApp.ProductCategoryBuilder