feat(retail): update the API

#### retail:v2alpha

The following keys were added:
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfig.properties.llmEmbeddingConfig.$ref
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfig.properties.llmEmbeddingConfig.description
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.description
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.id
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.properties.llmEmbeddingVersion.description
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.properties.llmEmbeddingVersion.type
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.type

The following keys were changed:
- schemas.GoogleCloudRetailV2alphaProduct.properties.retrievableFields.description

#### retail:v2beta

The following keys were added:
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfig.properties.llmEmbeddingConfig.$ref
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfig.properties.llmEmbeddingConfig.description
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.description
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.id
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.properties.llmEmbeddingVersion.description
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.properties.llmEmbeddingVersion.type
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.type

The following keys were changed:
- schemas.GoogleCloudRetailV2betaProduct.properties.retrievableFields.description

#### retail:v2

The following keys were added:
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfig.properties.llmEmbeddingConfig.$ref
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfig.properties.llmEmbeddingConfig.description
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.description
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.id
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.properties.llmEmbeddingVersion.description
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.properties.llmEmbeddingVersion.type
- schemas.GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig.type

The following keys were changed:
- schemas.GoogleCloudRetailV2Product.properties.retrievableFields.description

Author: yoshi-automation

discovery/retail-v2.json

@@ -2246,7 +2246,7 @@
       }
     }
   },
-  "revision": "20240920",
+  "revision": "20241003",
   "rootUrl": "https://retail.googleapis.com/",
   "schemas": {
     "GoogleApiHttpBody": {
@@ -4349,7 +4349,7 @@
         },
         "retrievableFields": {
           "deprecated": true,
-          "description": "Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form \"attributes.key\" where \"key\" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info The maximum number of paths is 30. Otherwise, an INVALID_ARGUMENT error is returned. Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.",
+          "description": "Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form \"attributes.key\" where \"key\" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.",
           "format": "google-fieldmask",
           "type": "string"
         },
@@ -6697,6 +6697,21 @@
         "frequentlyBoughtTogetherConfig": {
           "$ref": "GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig",
           "description": "Additional configs for frequently-bought-together models."
+        },
+        "llmEmbeddingConfig": {
+          "$ref": "GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig",
+          "description": "Optional. LLM embedding config to use for this model."
+        }
+      },
+      "type": "object"
+    },
+    "GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig": {
+      "description": "Config that turns on usage of llm embeddings as features to the model. Embeddings leverage unstructured text fields like description and title.",
+      "id": "GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig",
+      "properties": {
+        "llmEmbeddingVersion": {
+          "description": "Optional. The LLM embedding version to use. Currently only `v0` is supported. If not specified, feature will not be turned on.",
+          "type": "string"
         }
       },
       "type": "object"

discovery/retail-v2alpha.json

@@ -2767,7 +2767,7 @@
       }
     }
   },
-  "revision": "20240920",
+  "revision": "20241003",
   "rootUrl": "https://retail.googleapis.com/",
   "schemas": {
     "GoogleApiHttpBody": {
@@ -5705,6 +5705,21 @@
         "frequentlyBoughtTogetherConfig": {
           "$ref": "GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig",
           "description": "Additional configs for frequently-bought-together models."
+        },
+        "llmEmbeddingConfig": {
+          "$ref": "GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig",
+          "description": "Optional. LLM embedding config to use for this model."
+        }
+      },
+      "type": "object"
+    },
+    "GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig": {
+      "description": "Config that turns on usage of llm embeddings as features to the model. Embeddings leverage unstructured text fields like description and title.",
+      "id": "GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig",
+      "properties": {
+        "llmEmbeddingVersion": {
+          "description": "Optional. The LLM embedding version to use. Currently only `v0` is supported. If not specified, feature will not be turned on.",
+          "type": "string"
         }
       },
       "type": "object"
@@ -6172,7 +6187,7 @@
         },
         "retrievableFields": {
           "deprecated": true,
-          "description": "Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form \"attributes.key\" where \"key\" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info The maximum number of paths is 30. Otherwise, an INVALID_ARGUMENT error is returned. Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.",
+          "description": "Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form \"attributes.key\" where \"key\" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.",
           "format": "google-fieldmask",
           "type": "string"
         },

discovery/retail-v2beta.json

@@ -2391,7 +2391,7 @@
       }
     }
   },
-  "revision": "20240920",
+  "revision": "20241003",
   "rootUrl": "https://retail.googleapis.com/",
   "schemas": {
     "GoogleApiHttpBody": {
@@ -3662,6 +3662,21 @@
         "frequentlyBoughtTogetherConfig": {
           "$ref": "GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig",
           "description": "Additional configs for frequently-bought-together models."
+        },
+        "llmEmbeddingConfig": {
+          "$ref": "GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig",
+          "description": "Optional. LLM embedding config to use for this model."
+        }
+      },
+      "type": "object"
+    },
+    "GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig": {
+      "description": "Config that turns on usage of llm embeddings as features to the model. Embeddings leverage unstructured text fields like description and title.",
+      "id": "GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig",
+      "properties": {
+        "llmEmbeddingVersion": {
+          "description": "Optional. The LLM embedding version to use. Currently only `v0` is supported. If not specified, feature will not be turned on.",
+          "type": "string"
         }
       },
       "type": "object"
@@ -6150,7 +6165,7 @@
         },
         "retrievableFields": {
           "deprecated": true,
-          "description": "Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form \"attributes.key\" where \"key\" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info The maximum number of paths is 30. Otherwise, an INVALID_ARGUMENT error is returned. Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.",
+          "description": "Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form \"attributes.key\" where \"key\" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.",
           "format": "google-fieldmask",
           "type": "string"
         },

src/apis/retail/v2.ts

@@ -690,6 +690,19 @@ export namespace retail_v2 {
      * Additional configs for frequently-bought-together models.
      */
     frequentlyBoughtTogetherConfig?: Schema$GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig;
+    /**
+     * Optional. LLM embedding config to use for this model.
+     */
+    llmEmbeddingConfig?: Schema$GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig;
+  }
+  /**
+   * Config that turns on usage of llm embeddings as features to the model. Embeddings leverage unstructured text fields like description and title.
+   */
+  export interface Schema$GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig {
+    /**
+     * Optional. The LLM embedding version to use. Currently only `v0` is supported. If not specified, feature will not be turned on.
+     */
+    llmEmbeddingVersion?: string | null;
   }
   /**
    * The PageOptimizationConfig for model training. This determines how many panels to optimize for, and which serving configs to consider for each panel. The purpose of this model is to optimize which ServingConfig to show on which panels in way that optimizes the visitors shopping journey.
@@ -2582,7 +2595,7 @@ export namespace retail_v2 {
      */
     rating?: Schema$GoogleCloudRetailV2Rating;
     /**
-     * Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info The maximum number of paths is 30. Otherwise, an INVALID_ARGUMENT error is returned. Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+     * Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
      */
     retrievableFields?: string | null;
     /**

src/apis/retail/v2alpha.ts

@@ -1778,6 +1778,19 @@ export namespace retail_v2alpha {
      * Additional configs for frequently-bought-together models.
      */
     frequentlyBoughtTogetherConfig?: Schema$GoogleCloudRetailV2alphaModelFrequentlyBoughtTogetherFeaturesConfig;
+    /**
+     * Optional. LLM embedding config to use for this model.
+     */
+    llmEmbeddingConfig?: Schema$GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig;
+  }
+  /**
+   * Config that turns on usage of llm embeddings as features to the model. Embeddings leverage unstructured text fields like description and title.
+   */
+  export interface Schema$GoogleCloudRetailV2alphaModelModelFeaturesConfigLlmEmbeddingConfig {
+    /**
+     * Optional. The LLM embedding version to use. Currently only `v0` is supported. If not specified, feature will not be turned on.
+     */
+    llmEmbeddingVersion?: string | null;
   }
   /**
    * The PageOptimizationConfig for model training. This determines how many panels to optimize for, and which serving configs to consider for each panel. The purpose of this model is to optimize which ServingConfig to show on which panels in way that optimizes the visitors shopping journey.
@@ -2111,7 +2124,7 @@ export namespace retail_v2alpha {
      */
     rating?: Schema$GoogleCloudRetailV2alphaRating;
     /**
-     * Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info The maximum number of paths is 30. Otherwise, an INVALID_ARGUMENT error is returned. Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+     * Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
      */
     retrievableFields?: string | null;
     /**