@maxim_mazurok/gapi.client.retail-v2alpha 0.3.20260723 → 0.3.20260813

package/index.d.ts

@@ -1,4 +1,4 @@
-/* Type definitions for non-npm package Vertex AI Search for commerce API v2alpha 0.0 */
+/* Type definitions for non-npm package AI Commerce Search API v2alpha 0.0 */
 // Project: https://cloud.google.com/recommendations
 // Definitions by: Maxim Mazurok <https://github.com/Maxim-Mazurok>
 //                 Nick Amoscato <https://github.com/namoscato>
@@ -9,12 +9,12 @@
 // This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
 // In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
 // Generated from: https://retail.googleapis.com/$discovery/rest?version=v2alpha
-// Revision: 20260723
+// Revision: 20260813
 
 /// <reference types="gapi.client" />
 
 declare namespace gapi.client {
-  /** Load Vertex AI Search for commerce API v2alpha */
+  /** Load AI Commerce Search API v2alpha */
   function load(
     urlOrObject: 'https://retail.googleapis.com/$discovery/rest?version=v2alpha',
   ): Promise<void>;
@@ -350,6 +350,8 @@ declare namespace gapi.client {
       suggestions?: string[];
     }
     interface GoogleCloudRetailV2alphaCompleteQueryResponseCompletionResult {
+      /** Conversational prompts to trigger agents like Shopping Agent. There may be multiple prompts for a single suggestion. This is an experimental feature for select customers. If you want to receive this prompt information, reach out to the Retail support team. */
+      agentPrompts?: GoogleCloudRetailV2alphaCompleteQueryResponseCompletionResultAgentPrompt[];
       /** Custom attributes for the suggestion term. * For `user-data`, the attributes are additional custom attributes ingested through BigQuery. * For `cloud-retail`, the attributes are product attributes generated by Cloud Retail. It requires UserEvent.product_details is imported properly. */
       attributes?: {[P in string]: GoogleCloudRetailV2alphaCustomAttribute};
       /** Facet information for the suggestion term. Gives the number of items resulting from a search with this suggestion term for each facet. This is an experimental feature for limited customers. If you want to receive this facet information, reach out to the Retail support team. */
@@ -359,6 +361,10 @@ declare namespace gapi.client {
       /** Total number of products associated with a search with this suggestion. This is an experimental feature for limited customers. If you want to receive this product count information, reach out to the Retail support team. */
       totalProductCount?: number;
     }
+    interface GoogleCloudRetailV2alphaCompleteQueryResponseCompletionResultAgentPrompt {
+      /** The conversational prompt string. */
+      prompt?: string;
+    }
     interface GoogleCloudRetailV2alphaCompleteQueryResponseRecentSearchResult {
       /** The recent search query. */
       recentSearch?: string;
@@ -1494,6 +1500,8 @@ declare namespace gapi.client {
       canonicalFilter?: string;
       /** Optional. This field specifies all conversational related parameters addition to traditional retail search. */
       conversationalSearchSpec?: GoogleCloudRetailV2alphaSearchRequestConversationalSearchSpec;
+      /** Optional. A set of controls that are applied dynamically to the search request. These controls are applied in addition to the controls specified in the serving config. These controls are expected to not yet be persisted in storage. A control could be applied twice if it is in both the serving config and specified here. A maximum of 5 values are allowed. Otherwise, an INVALID_ARGUMENT error is returned. */
+      dynamicControls?: GoogleCloudRetailV2alphaControl[];
       /** Deprecated. Refer to https://cloud.google.com/retail/docs/configs#dynamic to enable dynamic facets. Do not set this field. The specification for dynamically generated facets. Notice that only textual facets can be dynamically generated. */
       dynamicFacetSpec?: GoogleCloudRetailV2alphaSearchRequestDynamicFacetSpec;
       /** The entity for customers that may run multiple different entities, domains, sites or regions, for example, `Google US`, `Google Ads`, `Waymo`, `google.com`, `youtube.com`, etc. If this is set, it should be exactly matched with UserEvent.entity to get search results boosted by entity. */
@@ -1504,6 +1512,8 @@ declare namespace gapi.client {
       facetSpecs?: GoogleCloudRetailV2alphaSearchRequestFacetSpec[];
       /** The filter syntax consists of an expression language for constructing a predicate from one or more fields of the products being filtered. Filter expression is case-sensitive. For more information, see [Filter](https://cloud.google.com/retail/docs/filter-and-order#filter). If this field is unrecognizable, an INVALID_ARGUMENT is returned. */
       filter?: string;
+      /** Optional. A list of control IDs to ignore. These controls will not be applied to the search request, even if they are specified in the serving config. */
+      ignoredControlIds?: string[];
       /** The labels applied to a resource must meet the following requirements: * Each resource can have multiple labels, up to a maximum of 64. * Each label must be a key-value pair. * Keys have a minimum length of 1 character and a maximum length of 63 characters and cannot be empty. Values can be empty and have a maximum length of 63 characters. * Keys and values can contain only lowercase letters, numeric characters, underscores, and dashes. All characters must use UTF-8 encoding, and international characters are allowed. * The key portion of a label must be unique. However, you can use the same key with multiple resources. * Keys must start with a lowercase letter or international character. For more information, see [Requirements for labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements) in the Resource Manager documentation. */
       labels?: {[P in string]: string};
       /** Optional. The BCP-47 language code, such as "en-US" or "sr-Latn" [list](https://www.unicode.org/cldr/charts/46/summary/root.html). For more information, see [Standardized codes](https://google.aip.dev/143). This field helps to better interpret the query. If a value isn't specified, the query language code is automatically detected, which may not be accurate. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@maxim_mazurok/gapi.client.retail-v2alpha",
-  "version": "0.3.20260723",
-  "description": "TypeScript typings for Vertex AI Search for commerce API v2alpha",
+  "version": "0.3.20260813",
+  "description": "TypeScript typings for AI Commerce Search API v2alpha",
   "repository": {
     "type": "git",
     "url": "https://github.com/Maxim-Mazurok/google-api-typings-generator.git"

package/readme.md

@@ -1,11 +1,11 @@
-# TypeScript typings for Vertex AI Search for commerce API v2alpha
+# TypeScript typings for AI Commerce Search API v2alpha
 
-Vertex AI Search for commerce API is made up of Retail Search, Browse and Recommendations. These discovery AI solutions help you implement personalized search, browse and recommendations, based on machine learning models, across your websites and mobile applications.
+The AI Commerce Search API is made up of Retail Search, Browse and Recommendations. These discovery AI solutions help you implement personalized search, browse and recommendations, based on machine learning models, across your websites and mobile applications.
 For detailed description please check [documentation](https://cloud.google.com/recommendations).
 
 ## Installing
 
-Install typings for Vertex AI Search for commerce API:
+Install typings for AI Commerce Search API:
 
 ```
 npm install @types/gapi.client.retail-v2alpha --save-dev
@@ -78,7 +78,7 @@ gapi.auth.authorize(
 );
 ```
 
-After that you can use Vertex AI Search for commerce API resources: <!-- TODO: make this work for multiple namespaces -->
+After that you can use AI Commerce Search API resources: <!-- TODO: make this work for multiple namespaces -->
 
 ```typescript
 /*