CommerceCatalog Class
Namespace
CommerceCatalog Methods
getProduct(webstoreId, productId, effectiveAccountId, fields, excludeFields, mediaGroups, excludeMedia, excludeEntitlementDetails, excludePrimaryProductCategory)
API Version
49.0
Available to Guest Users
51.0
Requires Chatter
No
Signature
public static ConnectApi.ProductDetail getProduct(String webstoreId, String productId, String effectiveAccountId, List<String> fields, Boolean excludeFields, List<String> mediaGroups, Boolean excludeMedia, Boolean excludeEntitlementDetails, Boolean excludePrimaryProductCategory)
Parameters
- webstoreId
- Type: String
- ID of the webstore.
- productId
- Type: String
- ID of the product.
- effectiveAccountId
- Type: String
- ID of the buyer account or guest buyer profile for which the request is made. If null, the default value is determined from context.
- fields
- Type: List<String>
- Comma-separated list of field names.
If this list is empty or unspecified, all fields are returned. There is no limit to the number of fields you can specify. The number of fields and number of characters in the field name may affect the URL size limit. If excludeFields and fields are specified, the excludeFields parameter takes precedence.
- excludeFields
- Type: Boolean
- Specifies whether the fields are returned (false) or not (true). If unspecified, defaults to false.
- mediaGroups
- Type: List<String>
- Comma-separated list of developer names of media
group records.
If this list is empty or unspecified, all media groups are returned. If excludeMedia and mediaGroups are specified, the excludeMedia parameter takes precedence.
- excludeMedia
- Type: Boolean
- Specifies whether the media groups and default images of the product are returned (false) or not (true). If unspecified, defaults to false.
- excludeEntitlementDetails
- Type: Boolean
- Specifies whether the entitlement details of the product are returned (false) or not (true). If unspecified, defaults to false.
- excludePrimaryProductCategory
- Type: Boolean
- Specifies whether the primary category path of the product is returned (false) or not (true). If unspecified, defaults to false.
Return Value
Type: ConnectApi.ProductDetail
Usage
This method respects buyer View Product entitlements and only users entitled to view product data can access it.
getProduct(webstoreId, productId, effectiveAccountId, fields, excludeFields, mediaGroups, excludeMedia, excludeEntitlementDetails, excludePrimaryProductCategory, excludeVariationInfo, excludeAttributeSetInfo)
API Version
50.0
Available to Guest Users
51.0
Requires Chatter
No
Signature
public static ConnectApi.ProductDetail getProduct(String webstoreId, String productId, String effectiveAccountId, List<String> fields, Boolean excludeFields, List<String> mediaGroups, Boolean excludeMedia, Boolean excludeEntitlementDetails, Boolean excludePrimaryProductCategory, Boolean excludeVariationInfo, Boolean excludeAttributeSetInfo)
Parameters
- webstoreId
- Type: String
- ID of the webstore.
- productId
- Type: String
- ID of the product.
- effectiveAccountId
- Type: String
- ID of the buyer account or guest buyer profile for which the request is made. If null, the default value is determined from context.
- fields
- Type: List<String>
- Comma-separated list of field names.
If this list is empty or unspecified, all fields are returned. There is no limit to the number of fields you can specify. The number of fields and number of characters in the field name may affect the URL size limit. If excludeFields and fields are specified, the excludeFields parameter takes precedence.
- excludeFields
- Type: Boolean
- Specifies whether the fields are returned (false) or not (true). If unspecified, defaults to false.
- mediaGroups
- Type: List<String>
- Comma-separated list of developer names of media
group records.
If this list is empty or unspecified, all media groups are returned. If excludeMedia and mediaGroups are specified, the excludeMedia parameter takes precedence.
- excludeMedia
- Type: Boolean
- Specifies whether the media groups and default images of the product are returned (false) or not (true). If unspecified, defaults to false.
- excludeEntitlementDetails
- Type: Boolean
- Specifies whether the entitlement details of the product are returned (false) or not (true). If unspecified, defaults to false.
- excludePrimaryProductCategory
- Type: Boolean
- Specifies whether the primary category path of the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeVariationInfo
- Type: Boolean
- Specifies whether the variation information for the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeAttributeSetInfo
- Type: Boolean
- Specifies whether the attribute set information for the product is returned (false) or not (true). If unspecified, defaults to false.
Return Value
Type: ConnectApi.ProductDetail
Usage
This method respects buyer View Product entitlements and only users entitled to view product data can access it.
getProduct(webstoreId, productId, effectiveAccountId, fields, excludeFields, mediaGroups, excludeMedia, excludeEntitlementDetails, excludePrimaryProductCategory, excludeVariationInfo, excludeAttributeSetInfo, excludeQuantityRule)
API Version
52.0
Available to Guest Users
52.0
Requires Chatter
No
Signature
public static ConnectApi.ProductDetail getProduct(String webstoreId, String productId, String effectiveAccountId, List<String> fields, Boolean excludeFields, List<String> mediaGroups, Boolean excludeMedia, Boolean excludeEntitlementDetails, Boolean excludePrimaryProductCategory, Boolean excludeVariationInfo, Boolean excludeAttributeSetInfo, Boolean excludeQuantityRule)
Parameters
- webstoreId
- Type: String
- ID of the webstore.
- productId
- Type: String
- ID of the product.
- effectiveAccountId
- Type: String
- ID of the buyer account or guest buyer profile for which the request is made. If null, the default value is determined from context.
- fields
- Type: List<String>
- Comma-separated list of field names.
If this list is empty or unspecified, all fields are returned. There is no limit to the number of fields you can specify. The number of fields and number of characters in the field name may affect the URL size limit. If excludeFields and fields are specified, the excludeFields parameter takes precedence.
- excludeFields
- Type: Boolean
- Specifies whether the fields are returned (false) or not (true). If unspecified, defaults to false.
- mediaGroups
- Type: List<String>
- Comma-separated list of developer names of media
group records.
If this list is empty or unspecified, all media groups are returned. If excludeMedia and mediaGroups are specified, the excludeMedia parameter takes precedence.
- excludeMedia
- Type: Boolean
- Specifies whether the media groups and default images of the product are returned (false) or not (true). If unspecified, defaults to false.
- excludeEntitlementDetails
- Type: Boolean
- Specifies whether the entitlement details of the product are returned (false) or not (true). If unspecified, defaults to false.
- excludePrimaryProductCategory
- Type: Boolean
- Specifies whether the primary category path of the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeVariationInfo
- Type: Boolean
- Specifies whether the variation information for the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeAttributeSetInfo
- Type: Boolean
- Specifies whether the attribute set information for the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeQuantityRule
- Type: Boolean
- Specifies whether the quantity rule information for the product is returned (false) or not (true). If unspecified, defaults to false.
Return Value
Type: ConnectApi.ProductDetail
Usage
This method respects buyer View Product entitlements and only users entitled to view product data can access it.
getProduct(webstoreId, productId, effectiveAccountId, fields, excludeFields, mediaGroups, excludeMedia, excludeEntitlementDetails, excludePrimaryProductCategory, excludeVariationInfo, excludeAttributeSetInfo, excludeQuantityRule, excludeProductSellingModels)
API Version
56.0
Available to Guest Users
56.0
Requires Chatter
No
Signature
public static ConnectApi.ProductDetail getProduct(String webstoreId, String productId, String effectiveAccountId, List<String> fields, Boolean excludeFields, List<String> mediaGroups, Boolean excludeMedia, Boolean excludeEntitlementDetails, Boolean excludePrimaryProductCategory, Boolean excludeVariationInfo, Boolean excludeAttributeSetInfo, Boolean excludeQuantityRule, Boolean excludeProductSellingModels)
Parameters
- webstoreId
- Type: String
- ID of the webstore.
- productId
- Type: String
- ID of the product.
- effectiveAccountId
- Type: String
- ID of the buyer account or guest buyer profile for which the request is made. If null, the default value is determined from context.
- fields
- Type: List<String>
- Comma-separated list of field names.
If this list is empty or unspecified, all fields are returned. There is no limit to the number of fields you can specify. The number of fields and number of characters in the field name may affect the URL size limit. If excludeFields and fields are specified, the excludeFields parameter takes precedence.
- excludeFields
- Type: Boolean
- Specifies whether the fields are returned (false) or not (true). If unspecified, defaults to false.
- mediaGroups
- Type: List<String>
- Comma-separated list of developer names of media
group records.
If this list is empty or unspecified, all media groups are returned. If excludeMedia and mediaGroups are specified, the excludeMedia parameter takes precedence.
- excludeMedia
- Type: Boolean
- Specifies whether the media groups and default images of the product are returned (false) or not (true). If unspecified, defaults to false.
- excludeEntitlementDetails
- Type: Boolean
- Specifies whether the entitlement details of the product are returned (false) or not (true). If unspecified, defaults to false.
- excludePrimaryProductCategory
- Type: Boolean
- Specifies whether the primary category path of the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeVariationInfo
- Type: Boolean
- Specifies whether the variation information for the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeAttributeSetInfo
- Type: Boolean
- Specifies whether the attribute set information for the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeQuantityRule
- Type: Boolean
- Specifies whether the quantity rule information for the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeProductSellingModels
- Type: Boolean
- Specifies whether product selling models are returned or not. The behavior of this parameter depends on whether you turn on the CommerceSubscription permission. If the permission is on, and if you set the parameter to false (or if you omit the parameter), product selling models are returned. If the permission is on, and if you set the parameter to true, product selling models are not returned. If the permission is off, product selling models are not returned, regardless of whether you omit the parameter or provide a value.
Return Value
Type: ConnectApi.ProductDetail
Usage
This method respects buyer View Product entitlements and only users entitled to view product data can access it.
getProduct(webstoreId, productId, effectiveAccountId, fields, mediaGroups, excludeFields, excludeMedia, excludePrimaryProductCategory, excludeVariationInfo, excludeAttributeSetInfo, excludeQuantityRule, excludeProductSellingModels)
API Version
57.0
Available to Guest Users
57.0
Requires Chatter
No
Signature
public static ConnectApi.ProductDetail getProduct(String webstoreId, String productId, String effectiveAccountId, List<String> fields, List<String> mediaGroups, Boolean excludeFields, Boolean excludeMedia, Boolean excludePrimaryProductCategory, Boolean excludeVariationInfo, Boolean excludeAttributeSetInfo, Boolean excludeQuantityRule, Boolean excludeProductSellingModels)
Parameters
- webstoreId
- Type: String
- ID of the webstore.
- productId
- Type: String
- ID of the product.
- effectiveAccountId
- Type: String
- ID of the buyer account or guest buyer profile for which the request is made. If null, the default value is determined from context.
- fields
- Type: List<String>
- Comma-separated list of field names.
If this list is empty or unspecified, all fields are returned. There is no limit to the number of fields you can specify. The number of fields and number of characters in the field name may affect the URL size limit. If excludeFields and fields are specified, the excludeFields parameter takes precedence.
- mediaGroups
- Type: List<String>
- Comma-separated list of developer names of media
group records.
If this list is empty or unspecified, all media groups are returned. If excludeMedia and mediaGroups are specified, the excludeMedia parameter takes precedence.
- excludeFields
- Type: Boolean
- Specifies whether the fields are returned (false) or not (true). If unspecified, defaults to false.
- excludeMedia
- Type: Boolean
- Specifies whether the media groups and default images of the product are returned (false) or not (true). If unspecified, defaults to false.
- excludePrimaryProductCategory
- Type: Boolean
- Specifies whether the primary category path of the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeVariationInfo
- Type: Boolean
- Specifies whether the variation information for the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeAttributeSetInfo
- Type: Boolean
- Specifies whether the attribute set information for the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeQuantityRule
- Type: Boolean
- Specifies whether the quantity rule information for the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeProductSellingModels
- Type: Boolean
- Specifies whether product selling models are returned or not. The behavior of this parameter depends on whether you turn on the CommerceSubscription permission. If the permission is on, and if you set the parameter to false (or if you omit the parameter), product selling models are returned. If the permission is on, and if you set the parameter to true, product selling models are not returned. If the permission is off, product selling models are not returned, regardless of whether you omit the parameter or provide a value.
Return Value
Type: ConnectApi.ProductDetail
Usage
This method respects buyer View Product entitlements and only users entitled to view product data can access it.
getProductCategory(webstoreId, productCategoryId, effectiveAccountId, fields, excludeFields, mediaGroups, excludeMedia)
API Version
49.0
Available to Guest Users
51.0
Requires Chatter
No
Signature
public static ConnectApi.ProductCategoryDetail getProductCategory(String webstoreId, String productCategoryId, String effectiveAccountId, List<String> fields, Boolean excludeFields, List<String> mediaGroups, Boolean excludeMedia)
Parameters
- webstoreId
- Type: String
- ID of the webstore.
- productCategoryId
- Type: String
- ID of the product category.
- effectiveAccountId
- Type: String
- ID of the buyer account or guest buyer profile for which the request is made. If null, the default value is determined from context.
- fields
- Type: List<String>
- Comma-separated list of field names.
If this list is empty or unspecified, all fields are returned. There is no limit to the number of fields you can specify. The number of fields and number of characters in the field name may affect the URL size limit. If excludeFields and fields are specified, the excludeFields parameter takes precedence.
- excludeFields
- Type: Boolean
- Specifies whether the fields are returned (false) or not (true). If unspecified, defaults to false.
- mediaGroups
- Type: List<String>
- Comma-separated list of developer names of media
group records.
If this list is empty or unspecified, all media groups are returned. If excludeMedia and mediaGroups are specified, the excludeMedia parameter takes precedence.
- excludeMedia
- Type: Boolean
- Specifies whether the media groups and default images of the product are returned (false) or not (true). If unspecified, defaults to false.
Return Value
getProductCategoryChildren(webstoreId, effectiveAccountId, parentProductCategoryId, fields, excludeFields, mediaGroups, excludeMedia)
API Version
52.0
Available to Guest Users
52.0
Requires Chatter
No
Signature
public static ConnectApi.ProductCategoryDetailCollection getProductCategoryChildren(String webstoreId, String effectiveAccountId, String parentProductCategoryId, List<String> fields, Boolean excludeFields, List<String> mediaGroups, Boolean excludeMedia)
Parameters
- webstoreId
- Type: String
- ID of the webstore.
- effectiveAccountId
- Type: String
- ID of the buyer account or guest buyer profile for which the request is made. If null, the default value is determined from context.
- parentProductCategoryId
- Type: String
- ID of the product category for which you want to get all the children product categories. If null, returns all the top-level product categories for the store.
- fields
- Type: List<String>
- Comma-separated list of field names.
If this list is empty or unspecified, all fields are returned. There is no limit to the number of fields you can specify. The number of fields and number of characters in the field name may affect the URL size limit. If excludeFields and fields are specified, the excludeFields parameter takes precedence.
- excludeFields
- Type: Boolean
- Specifies whether the fields are returned (false) or not (true). If unspecified, defaults to false.
- mediaGroups
- Type: List<String>
- Comma-separated list of developer names of media
group records.
If this list is empty or unspecified, all media groups are returned. If excludeMedia and mediaGroups are specified, the excludeMedia parameter takes precedence.
- excludeMedia
- Type: Boolean
- Specifies whether the media groups and default images of the product are returned (false) or not (true). If unspecified, defaults to false.
Return Value
getProductCategoryPath(webstoreId, productCategoryId)
API Version
49.0
Available to Guest Users
51.0
Requires Chatter
No
Signature
public static ConnectApi.ProductCategoryPath getProductCategoryPath(String webstoreId, String productCategoryId)
Parameters
Return Value
Usage
This method respects buyer View Product entitlements and only users entitled to view product data can access it.
getProductChildCollection(webstoreId, productId, effectiveAccountId, fields, mediaGroups, excludeFields, excludeMedia, excludeAttributeSetInfo, excludeQuantityRule, pageToken, pageSize)
API Version
57.0
Available to Guest Users
57.0
Requires Chatter
No
Signature
public static ConnectApi.ProductChildCollection getProductChildCollection(String webstoreId, String productId, String effectiveAccountId, List<String> fields, List<String> mediaGroups, Boolean excludeFields, Boolean excludeMedia, Boolean excludeAttributeSetInfo, Boolean excludeQuantityRule, String pageToken, Integer pageSize)
Parameters
- webstoreId
- Type: String
- ID of the webstore.
- productId
- Type: String
- ID of the product.
- effectiveAccountId
- Type: String
- ID of the buyer account or guest buyer profile for which the request is made. If unspecified, the default value is determined from context.
- fields
- Type: List<String>
-
Comma-separated list of field names.
If this list is empty or unspecified, all fields are returned. There’s no limit to the number of fields you can specify. The number of fields and number of characters in the field name may affect the URL size limit. If excludeFields and fields are specified, the excludeFields parameter takes precedence.
- mediaGroups
- Type: List<String>
-
Comma-separated list of developer names of media group records.
Possible values:
- Attachment
- productDetailImage
- productListImage
If this list is empty or unspecified, all media groups are returned. If excludeMedia and mediaGroups are specified, the excludeMedia parameter takes precedence.
For product bundles, only the producListImage is returned.
- excludeFields
- Type: Boolean
- Specifies whether the fields are returned (false) or not (true). If unspecified, defaults to false.
- excludeMedia
- Type: Boolean
- Specifies whether the media groups and default images of the product are returned (false) or not (true). If unspecified, defaults to false.
- excludeAttributeSetInfo
- Type: Boolean
- Specifies whether the attribute set information for the product is returned (false) or not (true). If unspecified, defaults to false.
- excludeQuantityRule
- Type: Boolean
- Specifies whether the quantity rule information for the product is returned (false) or not (true). If unspecified, defaults to false.
- pageToken
- Type: String
- Specifies the base64 encoded page token. Page tokens are returned as part of the response. If unspecified, the first page is returned.
- pageSize
- Type: Integer
- Specifies the number of items per page. Valid values are from 1 through 100. If you don’t specify a value, the default size is 20.
Return Value
getProducts(webstoreId, effectiveAccountId, ids, skus, fields, excludeMedia, excludePrices)
API Version
54.0
Available to Guest Users
54.0
Requires Chatter
No
Signature
public static ConnectApi.ProductOverviewCollection getProducts(String webstoreId, String effectiveAccountId, List<String> ids, List<String> skus, List<String> fields, Boolean excludeMedia, Boolean excludePrices)
Parameters
- webstoreId
- Type: String
- ID of the webstore.
- effectiveAccountId
- Type: String
- ID of the buyer account or guest buyer profile for which the request is made. If unspecified, the default value is determined from context.
- ids
- Type: List<String>
- List of product IDs. Specify either a list of up to 20 product IDs or SKUs, but not both.
- skus
- Type: List<String>
- List of SKUs. Specify either a list of up to 20 SKUs or product IDs, but not both.
- fields
- Type: List<String>
- Comma-separated list of field names to return for each product. If the list is empty or not specified, all fields are returned. You can specify any number of fields.
- excludeMedia
- Type: Boolean
- Specifies whether default images are returned for the products (false) or not (true). The default is false.
- excludePrices
- Type: Boolean
- Specifies whether prices are returned for the products (false) or not (true). The default is false.
Return Value
getProducts(webstoreId, effectiveAccountId, ids, skus, fields, excludeMedia)
API Version
58.0
Available to Guest Users
58.0
Requires Chatter
No
Signature
public static ConnectApi.ProductOverviewCollection getProducts(String webstoreId, String effectiveAccountId, List<String> ids, List<String> skus, List<String> fields, Boolean excludeMedia)
Parameters
- webstoreId
- Type: String
- ID of the webstore.
- effectiveAccountId
- Type: String
- ID of the buyer account or guest buyer profile for which the request is made. If null, the default value is determined from context.
- ids
- Type: List<String>
- List of product IDs. Specify either a list of up to 20 product IDs or SKUs, but not both.
- skus
- Type: List<String>
- List of SKUs. Specify either a list of up to 20 SKUs or product IDs, but not both.
- fields
- Type: List<String>
- Comma-separated list of field names to return for each product. If the list is empty or not specified, all fields are returned. You can specify any number of fields.
- excludeMedia
- Type: Boolean
- Specifies whether default images are returnedSpecifies whether the media groups and default images of the product are returned (false) or not (true). If unspecified, defaults to false.