CatalogQuery

November 20, 2019 ยท View on GitHub

Description

A query to be applied to a SearchCatalogObjectsRequest. Only one query field may be present. Where an attribute name is required, it should be specified as the name of any field marked "searchable" from the structured data types for the desired result object type(s) (CatalogItem, CatalogItemVariation, CatalogCategory, CatalogTax, CatalogDiscount, CatalogModifierList, CatalogModifier). For example, a query that should return Items may specify attribute names from any of the searchable fields of the CatalogItem data type, namely \"name\", \"description\", and \"abbreviation\".

Properties

NameTypeDescriptionNotes
sortedAttributeQueryCatalogQuerySortedAttributeA query that returns all objects, sorted by the given attribute.[optional]
exactQueryCatalogQueryExactA query that returns only objects for which the given (string-valued) attribute has the given case-insensitive value.[optional]
prefixQueryCatalogQueryPrefixA query that returns only objects for which the given (string-valued) attribute has the given case-insensitive prefix.[optional]
rangeQueryCatalogQueryRangeA query that returns only objects for which the given (integer-valued) attribute lies in the given range.[optional]
textQueryCatalogQueryTextA query that returns only objects whose searchable attributes contain all of the given keywords as prefixes. For example, if a `CatalogItem` contains attributes `{"name": "t-shirt"}` and `{"description": "Small, Purple"}`, it will be matched by the query `{"keywords": ["shirt", "sma", "purp"]}`.[optional]
itemsForTaxQueryCatalogQueryItemsForTaxA query that returns all `CatalogItem`s that have any of the given `CatalogTax`es enabled.[optional]
itemsForModifierListQueryCatalogQueryItemsForModifierListA query that returns all `CatalogItem`s that have any of the given `CatalogModifierList`s enabled.[optional]
itemsForItemOptionsQueryCatalogQueryItemsForItemOptionsA query that returns all `CatalogItem`s that have all of the given `CatalogItemOption`s.[optional]
itemVariationsForItemOptionValuesQueryCatalogQueryItemVariationsForItemOptionValuesA query that returns all `CatalogItemVariation`s that have all of the given `CatalogItemOption` values.[optional]