public RepeatedField<CatalogItem.Types.CategoryHierarchy> CategoryHierarchies { get; }
Required. Catalog item categories. This field is repeated for supporting
one catalog item belonging to several parallel category hierarchies.
For example, if a shoes product belongs to both
["Shoes & Accessories" -> "Shoes"] and
["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be
represented as:
Required. Catalog item identifier. UTF-8 encoded string with a length limit
of 128 bytes.
This id must be unique among all catalog items within the same catalog. It
should also be used when logging user events in order for the user events
to be joined with the Catalog.
Optional. Highly encouraged. Extra catalog item attributes to be
included in the recommendation model. For example, for retail products,
this could include the store name, vendor, style, color, etc. These are
very strong signals for recommendation model, thus we highly recommend
providing the item attributes here.
Optional. Language of the title/description/item_attributes. Use language
tags defined by BCP 47. https://www.rfc-editor.org/rfc/bcp/bcp47.txt. Our
supported language codes include 'en', 'es', 'fr', 'de', 'ar', 'fa', 'zh',
'ja', 'ko', 'sv', 'ro', 'nl'. For other languages, contact
your Google account manager.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eCatalogItem\u003c/code\u003e class represents metadata information for items to be recommended within the Recommendations AI v1beta1 API.\u003c/p\u003e\n"],["\u003cp\u003eIt supports multiple category hierarchies for a single item, using the \u003ccode\u003eCategoryHierarchies\u003c/code\u003e property to define different category paths.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eId\u003c/code\u003e property is a required unique identifier for each item within a catalog, and is used to connect user events with catalog items.\u003c/p\u003e\n"],["\u003cp\u003eThe class includes properties such as \u003ccode\u003eTitle\u003c/code\u003e, \u003ccode\u003eDescription\u003c/code\u003e, \u003ccode\u003eItemAttributes\u003c/code\u003e, and \u003ccode\u003eTags\u003c/code\u003e to provide detailed information about each item, allowing for enhanced filtering and recommendation modeling.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eCatalogItem\u003c/code\u003e implements several interfaces, including \u003ccode\u003eIMessage\u003c/code\u003e, \u003ccode\u003eIEquatable\u003c/code\u003e, \u003ccode\u003eIDeepCloneable\u003c/code\u003e, and \u003ccode\u003eIBufferMessage\u003c/code\u003e, and inherits members from the \u003ccode\u003eobject\u003c/code\u003e class.\u003c/p\u003e\n"]]],[],null,["# Recommendations AI v1beta1 API - Class CatalogItem (2.0.0-beta06)\n\nVersion latestkeyboard_arrow_down\n\n- [2.0.0-beta06 (latest)](/dotnet/docs/reference/Google.Cloud.RecommendationEngine.V1Beta1/latest/Google.Cloud.RecommendationEngine.V1Beta1.CatalogItem)\n- [2.0.0-beta05](/dotnet/docs/reference/Google.Cloud.RecommendationEngine.V1Beta1/2.0.0-beta05/Google.Cloud.RecommendationEngine.V1Beta1.CatalogItem)\n- [1.0.0-beta03](/dotnet/docs/reference/Google.Cloud.RecommendationEngine.V1Beta1/1.0.0-beta03/Google.Cloud.RecommendationEngine.V1Beta1.CatalogItem) \n\n public sealed class CatalogItem : IMessage\u003cCatalogItem\u003e, IEquatable\u003cCatalogItem\u003e, IDeepCloneable\u003cCatalogItem\u003e, IBufferMessage, IMessage\n\nReference documentation and code samples for the Recommendations AI v1beta1 API class CatalogItem.\n\nCatalogItem captures all metadata information of items to be recommended. \n\nInheritance\n-----------\n\n[object](https://learn.microsoft.com/dotnet/api/system.object) \\\u003e CatalogItem \n\nImplements\n----------\n\n[IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage-1.html)[CatalogItem](/dotnet/docs/reference/Google.Cloud.RecommendationEngine.V1Beta1/latest/Google.Cloud.RecommendationEngine.V1Beta1.CatalogItem), [IEquatable](https://learn.microsoft.com/dotnet/api/system.iequatable-1)[CatalogItem](/dotnet/docs/reference/Google.Cloud.RecommendationEngine.V1Beta1/latest/Google.Cloud.RecommendationEngine.V1Beta1.CatalogItem), [IDeepCloneable](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IDeepCloneable-1.html)[CatalogItem](/dotnet/docs/reference/Google.Cloud.RecommendationEngine.V1Beta1/latest/Google.Cloud.RecommendationEngine.V1Beta1.CatalogItem), [IBufferMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IBufferMessage.html), [IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage.html) \n\nInherited Members\n-----------------\n\n[object.GetHashCode()](https://learn.microsoft.com/dotnet/api/system.object.gethashcode) \n[object.GetType()](https://learn.microsoft.com/dotnet/api/system.object.gettype) \n[object.ToString()](https://learn.microsoft.com/dotnet/api/system.object.tostring)\n\nNamespace\n---------\n\n[Google.Cloud.RecommendationEngine.V1Beta1](/dotnet/docs/reference/Google.Cloud.RecommendationEngine.V1Beta1/latest/Google.Cloud.RecommendationEngine.V1Beta1)\n\nAssembly\n--------\n\nGoogle.Cloud.RecommendationEngine.V1Beta1.dll\n\nConstructors\n------------\n\n### CatalogItem()\n\n public CatalogItem()\n\n### CatalogItem(CatalogItem)\n\n public CatalogItem(CatalogItem other)\n\nProperties\n----------\n\n### CategoryHierarchies\n\n public RepeatedField\u003cCatalogItem.Types.CategoryHierarchy\u003e CategoryHierarchies { get; }\n\nRequired. Catalog item categories. This field is repeated for supporting\none catalog item belonging to several parallel category hierarchies.\n\nFor example, if a shoes product belongs to both\n\\[\"Shoes \\& Accessories\" -\\\u003e \"Shoes\"\\] and\n\\[\"Sports \\& Fitness\" -\\\u003e \"Athletic Clothing\" -\\\u003e \"Shoes\"\\], it could be\nrepresented as: \n\n \"categoryHierarchies\": [\n { \"categories\": [\"Shoes & Accessories\", \"Shoes\"]},\n { \"categories\": [\"Sports & Fitness\", \"Athletic Clothing\", \"Shoes\"] }\n ]\n\n### Description\n\n public string Description { get; set; }\n\nOptional. Catalog item description. UTF-8 encoded string with a length\nlimit of 5 KiB.\n\n### Id\n\n public string Id { get; set; }\n\nRequired. Catalog item identifier. UTF-8 encoded string with a length limit\nof 128 bytes.\n\nThis id must be unique among all catalog items within the same catalog. It\nshould also be used when logging user events in order for the user events\nto be joined with the Catalog.\n\n### ItemAttributes\n\n public FeatureMap ItemAttributes { get; set; }\n\nOptional. Highly encouraged. Extra catalog item attributes to be\nincluded in the recommendation model. For example, for retail products,\nthis could include the store name, vendor, style, color, etc. These are\nvery strong signals for recommendation model, thus we highly recommend\nproviding the item attributes here.\n\n### ItemGroupId\n\n public string ItemGroupId { get; set; }\n\nOptional. Variant group identifier for prediction results. UTF-8 encoded\nstring with a length limit of 128 bytes.\n\nThis field must be enabled before it can be used. [Learn\nmore](/recommendations-ai/docs/catalog#item-group-id).\n\n### LanguageCode\n\n public string LanguageCode { get; set; }\n\nOptional. Language of the title/description/item_attributes. Use language\ntags defined by BCP 47. \u003chttps://www.rfc-editor.org/rfc/bcp/bcp47.txt\u003e. Our\nsupported language codes include 'en', 'es', 'fr', 'de', 'ar', 'fa', 'zh',\n'ja', 'ko', 'sv', 'ro', 'nl'. For other languages, contact\nyour Google account manager.\n\n### ProductMetadata\n\n public ProductCatalogItem ProductMetadata { get; set; }\n\nOptional. Metadata specific to retail products.\n\n### RecommendationTypeCase\n\n public CatalogItem.RecommendationTypeOneofCase RecommendationTypeCase { get; }\n\n### Tags\n\n public RepeatedField\u003cstring\u003e Tags { get; }\n\nOptional. Filtering tags associated with the catalog item. Each tag should\nbe a UTF-8 encoded string with a length limit of 1 KiB.\n\nThis tag can be used for filtering recommendation results by passing the\ntag as part of the predict request filter.\n\n### Title\n\n public string Title { get; set; }\n\nRequired. Catalog item title. UTF-8 encoded string with a length limit of 1\nKiB."]]
