How can I retrieve full product attributes and filter by title using Vertex AI Commerce API?

Below is an outline of how to get what you need:

1. Understanding the Endpoints:

   • The search endpoint (served via servingConfigs/search) is optimized for relevance and speed so by default it returns a “summary” of product information (typically id and name).
   • The products/list endpoint returns the full product objects, but its filtering options are limited (only supporting preconfigured attributes).

2. Making Your Product Attributes Filterable:
   To filter by title and have that show up in your full product details, you must update your catalog’s attribute configuration so that the title (or any other attribute you want to filter on) is marked as filterable. This involves:

   • Going to your catalog configuration (usually via the Retail Console or corresponding API).
   • Updating the metadata for your product attributes and marking “title” as filterable.

3. Recommended Method:

   • Step 1: Update your catalog configuration so that the “title” field is indexed for filtering. This tells the serving system that title should be an available field when filtering products.
   • Step 2: Then use the search endpoint with the appropriate filter parameter (for example, something like filter="title:scissors") so that you get only the products matching your criteria.
   • Step 3: Alternatively, if you require the full product detail that the search endpoint does not return by default, you can use the search endpoint to get a list of matching product IDs and then use the GET product or the list endpoint (with your filtered set) to retrieve the full product details.

4. Example Approach:
   Assuming you have updated your attribute configuration to allow filtering by title, you’d do something like:

   JSONCopied
   {
     "query": "scissors",
     "visitorId": "100",
     "filter": "title:scissors",
     "pageSize": 10
   }

   This request to the search endpoint should now only return products whose title includes “scissors”. If the search endpoint response still only returns summary fields, then use the returned product IDs to call the GET product endpoint (or call the list endpoint with an additional field mask if available) which will return all the attributes.

5. Summary:

   • Update your catalog so that “title” (or other fields) is filterable.
   • Use the search endpoint with a proper filter to narrow down the search.
   • If you need complete product details, perform a subsequent lookup (or configure the search response to include a full field mask if available).

This two-step process (filter via search then retrieve full details via GET) is the recommended workflow when the default search response is a lightweight summary.