AdsApp.ProductCategoryBuilder
Stay organized with collections
Save and categorize content based on your preferences.
Builder for
ProductCategory
objects.
Methods:
build()
Builds the product category. Returns a
ProductCategoryOperation that corresponds
to the creation of the
ProductCategory.
Return values:
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:
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:
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:
withValue(value)
Specifies the value of the product category.
Arguments:
Name | Type | Description |
value |
String |
The value. |
Return values:
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:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-25 UTC.
[null,null,["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThis page documents the \u003ccode\u003eProductCategoryBuilder\u003c/code\u003e for creating and managing product categories in Google Ads scripts.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eProductCategoryBuilder\u003c/code\u003e allows specifying the bid, name, and value for a new product category.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ebuild()\u003c/code\u003e method finalizes the product category creation and returns a \u003ccode\u003eProductCategoryOperation\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIt's crucial to specify the product category name using \u003ccode\u003ewithName()\u003c/code\u003e before building, otherwise it will fail.\u003c/p\u003e\n"],["\u003cp\u003eYou can optionally provide a language code for localizing the product category name using \u003ccode\u003ewithName()\u003c/code\u003e and \u003ccode\u003ewithValue()\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# AdsApp.ProductCategoryBuilder\n\nBuilder for [ProductCategory](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategory) objects.\n\n### Methods:\n\n| Member | Type | Description |\n|-----------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------|-------------------------------------------------|\n| [build()](#build) | [AdsApp.ProductCategoryOperation](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategoryoperation) | Builds the product category. |\n| [withBid(bid)](#withBid_bid) | [AdsApp.ProductCategoryBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategorybuilder) | Specifies the bid of the product category. |\n| [withName(productCategoryName)](#withName_productCategoryName) | [AdsApp.ProductCategoryBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategorybuilder) | Specifies the name of the new product category. |\n| [withName(productCategoryName, optionalLanguageCode)](#withName_productCategoryName-optionalLanguageCode) | [AdsApp.ProductCategoryBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategorybuilder) | Specifies the name of the new product category. |\n| [withValue(value)](#withValue_value) | [AdsApp.ProductCategoryBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategorybuilder) | Specifies the value of the product category. |\n| [withValue(value, optionalLanguageCode)](#withValue_value-optionalLanguageCode) | [AdsApp.ProductCategoryBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategorybuilder) | |\n\n`build()`\n---------\n\nBuilds the product category. Returns a [ProductCategoryOperation](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategoryoperation) that corresponds to the creation of the [ProductCategory](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategory).\n\n### Return values:\n\n| Type | Description |\n|--------------------------------------------------------------------------------------------------------------|-------------------------------|\n| [AdsApp.ProductCategoryOperation](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategoryoperation) | The ProductCategoryOperation. |\n\n`withBid(bid)`\n--------------\n\nSpecifies the bid of the product category. If this is unspecified, will use the bid of the parent product group.\n\n### Arguments:\n\n| Name | Type | Description |\n|------|----------|-------------|\n| bid | `double` | The bid. |\n\n### Return values:\n\n| Type | Description |\n|----------------------------------------------------------------------------------------------------------|----------------------------------------------------|\n| [AdsApp.ProductCategoryBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategorybuilder) | The ProductCategoryBuilder with the specified bid. |\n\n`withName(productCategoryName)`\n-------------------------------\n\nSpecifies the name of the new product category. If the name is unspecified before calling 'build', the category will fail to build.\n\n### Arguments:\n\n| Name | Type | Description |\n|---------------------|----------|---------------------------------------------------|\n| productCategoryName | `String` | The name to specify for the new product category. |\n\n### Return values:\n\n| Type | Description |\n|----------------------------------------------------------------------------------------------------------|---------------------------|\n| [AdsApp.ProductCategoryBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategorybuilder) | Product category builder. |\n\n`withName(productCategoryName, optionalLanguageCode)`\n-----------------------------------------------------\n\nSpecifies the name of the new product category. If the name is unspecified before calling 'build', the category will fail to build.\n\n### Arguments:\n\n| Name | Type | Description |\n|----------------------|----------|--------------------------------------------------------------------------------------|\n| productCategoryName | `String` | The name to specify for the new product category. |\n| optionalLanguageCode | `String` | **Optional**locale to be used for localising the product bidding category names.**** |\n\n### Return values:\n\n| Type | Description |\n|----------------------------------------------------------------------------------------------------------|---------------------------|\n| [AdsApp.ProductCategoryBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategorybuilder) | Product category builder. |\n\n`withValue(value)`\n------------------\n\nSpecifies the value of the product category.\n\n### Arguments:\n\n| Name | Type | Description |\n|-------|----------|-------------|\n| value | `String` | The value. |\n\n### Return values:\n\n| Type | Description |\n|----------------------------------------------------------------------------------------------------------|------------------------------------------------------|\n| [AdsApp.ProductCategoryBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategorybuilder) | The ProductCategoryBuilder with the specified value. |\n\n`withValue(value, optionalLanguageCode)`\n----------------------------------------\n\n### Arguments:\n\n| Name | Type | Description |\n|----------------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------|\n| value | `String` | |\n| optionalLanguageCode | `String` | **Optional**locale to be used for localising the product bidding category names. If unspecified, the language code defaults to \"en-US\".**** |\n\n### Return values:\n\n| Type | Description |\n|----------------------------------------------------------------------------------------------------------|-------------|\n| [AdsApp.ProductCategoryBuilder](/google-ads/scripts/docs/reference/adsapp/adsapp_productcategorybuilder) | |"]]