v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-13175378.4 KB
projects

Creates a catalog item.

post/v1beta1/{+parent}/catalogItems

Path parameters

parentstring required

Required. The parent catalog resource name, such as projects/*/locations/global/catalogs/default_catalog.

Request body

descriptionstring

Optional. Catalog item description. UTF-8 encoded string with a length limit of 5 KiB.

titlestring

Required. Catalog item title. UTF-8 encoded string with a length limit of 1 KiB.

tagsstring[]

Optional. Filtering tags associated with the catalog item. Each tag should be a UTF-8 encoded string with a length limit of 1 KiB. This tag can be used for filtering recommendation results by passing the tag as part of the predict request filter.

itemGroupIdstring

Optional. Variant group identifier for prediction results. UTF-8 encoded string with a length limit of 128 bytes. This field must be enabled before it can be used. Learn more.

idstring

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.

languageCodestring

Optional. Deprecated. The model automatically detects the text language. Your catalog can include text in different languages, but duplicating catalog items to provide text in multiple languages can result in degraded model performance.

Response

Successful response