Skip to main content

catalogs

Creates, updates, deletes, gets or lists a catalogs resource.

Overview

Namecatalogs
TypeResource
Idgoogle.recommendationengine.catalogs

Fields

The following fields are returned by SELECT queries:

Successful response

NameDatatypeDescription
namestringThe fully qualified resource name of the catalog.
catalogItemLevelConfigobjectRequired. The catalog item level configuration. (id: GoogleCloudRecommendationengineV1beta1CatalogItemLevelConfig)
defaultEventStoreIdstringRequired. The ID of the default event store.
displayNamestringRequired. The catalog display name.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
projects_locations_catalogs_listselectprojectsId, locationsIdpageSize, pageTokenLists all the catalog configurations associated with the project.
projects_locations_catalogs_patchupdateprojectsId, locationsId, catalogsIdupdateMaskUpdates the catalog configuration.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
catalogsIdstring
locationsIdstring
projectsIdstring
pageSizeinteger (int32)
pageTokenstring
updateMaskstring (google-fieldmask)

SELECT examples

Lists all the catalog configurations associated with the project.

SELECT
name,
catalogItemLevelConfig,
defaultEventStoreId,
displayName
FROM google.recommendationengine.catalogs
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}';

UPDATE examples

Updates the catalog configuration.

UPDATE google.recommendationengine.catalogs
SET
data__name = '{{ name }}',
data__displayName = '{{ displayName }}',
data__defaultEventStoreId = '{{ defaultEventStoreId }}',
data__catalogItemLevelConfig = '{{ catalogItemLevelConfig }}'
WHERE
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND catalogsId = '{{ catalogsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
catalogItemLevelConfig,
defaultEventStoreId,
displayName;