feat(retail): update the API

#### retail:v2alpha

The following keys were added:
- schemas.GoogleCloudRetailV2alphaConversationalSearchResponse.properties.conversationalTextResponse.description
- schemas.GoogleCloudRetailV2alphaConversationalSearchResponse.properties.conversationalTextResponse.type
- schemas.GoogleCloudRetailV2alphaConversationalSearchResponse.properties.followupQuestion.$ref
- schemas.GoogleCloudRetailV2alphaConversationalSearchResponse.properties.followupQuestion.description
- schemas.GoogleCloudRetailV2alphaConversationalSearchResponse.properties.state.description
- schemas.GoogleCloudRetailV2alphaConversationalSearchResponse.properties.state.enum
- schemas.GoogleCloudRetailV2alphaConversationalSearchResponse.properties.state.enumDescriptions
- schemas.GoogleCloudRetailV2alphaConversationalSearchResponse.properties.state.readOnly
- schemas.GoogleCloudRetailV2alphaConversationalSearchResponse.properties.state.type
- schemas.GoogleCloudRetailV2alphaConversationalSearchResponse.properties.userQueryTypes.description
- schemas.GoogleCloudRetailV2alphaConversationalSearchResponse.properties.userQueryTypes.items.type
- schemas.GoogleCloudRetailV2alphaConversationalSearchResponse.properties.userQueryTypes.type

The following keys were changed:
- schemas.GoogleCloudRetailV2alphaConversationalSearchRequestConversationalFilteringSpec.properties.conversationalFilteringMode.enum
- schemas.GoogleCloudRetailV2alphaConversationalSearchRequestConversationalFilteringSpec.properties.conversationalFilteringMode.enumDescriptions

Author: yoshi-automation

discovery/retail-v2alpha.json

@@ -2859,7 +2859,7 @@
       }
     }
   },
-  "revision": "20250717",
+  "revision": "20250724",
   "rootUrl": "https://retail.googleapis.com/",
   "schemas": {
     "GoogleApiHttpBody": {
@@ -4699,10 +4699,14 @@
           "description": "Optional. Mode to control Conversational Filtering. Defaults to Mode.DISABLED if it's unset.",
           "enum": [
             "MODE_UNSPECIFIED",
+            "DISABLED",
+            "ENABLED",
             "CONVERSATIONAL_FILTER_ONLY"
           ],
           "enumDescriptions": [
             "Default value.",
+            "Disable Conversational Filtering.",
+            "Enabled Conversational Filtering with default Conversational Search.",
             "Enabled Conversational Filtering without default Conversational Search."
           ],
           "type": "string"
@@ -4780,12 +4784,42 @@
           "$ref": "GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResult",
           "description": "This field specifies all related information that is needed on client side for UI rendering of conversational filtering search."
         },
+        "conversationalTextResponse": {
+          "description": "The conversational answer-based text response generated by the Server.",
+          "type": "string"
+        },
+        "followupQuestion": {
+          "$ref": "GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestion",
+          "description": "The conversational followup question generated for Intent refinement."
+        },
         "refinedSearch": {
           "description": "The proposed refined search queries. They can be used to fetch the relevant search results. When using CONVERSATIONAL_FILTER_ONLY mode, the refined_query from search response will be populated here.",
           "items": {
             "$ref": "GoogleCloudRetailV2alphaConversationalSearchResponseRefinedSearch"
           },
           "type": "array"
+        },
+        "state": {
+          "description": "Output only. The state of the response generation.",
+          "enum": [
+            "STATE_UNSPECIFIED",
+            "STREAMING",
+            "SUCCEEDED"
+          ],
+          "enumDescriptions": [
+            "Unknown.",
+            "Response generation is being streamed.",
+            "Response generation has succeeded."
+          ],
+          "readOnly": true,
+          "type": "string"
+        },
+        "userQueryTypes": {
+          "description": "The types Retail classifies the search query as. Supported values are: - \"ADVERSARIAL\" - \"CHITCHAT\" - \"JAILBREAK\" - \"ORDER_SUPPORT\" - \"SIMPLE_PRODUCT_SEARCH\" - \"INTENT_REFINEMENT\" - \"PRODUCT_DETAILS\" - \"PRODUCT_COMPARISON\" - \"DEALS_AND_COUPONS\" - \"STORE_RELEVANT\" - \"BLOCKLISTED\" - \"BEST_PRODUCT\" - \"RETAIL_SUPPORT\" - \"DISABLED\" clang-format off clang-format on",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
         }
       },
       "type": "object"

src/apis/retail/v2alpha.ts

@@ -1087,14 +1087,30 @@ export namespace retail_v2alpha {
      * This field specifies all related information that is needed on client side for UI rendering of conversational filtering search.
      */
     conversationalFilteringResult?: Schema$GoogleCloudRetailV2alphaConversationalSearchResponseConversationalFilteringResult;
+    /**
+     * The conversational answer-based text response generated by the Server.
+     */
+    conversationalTextResponse?: string | null;
     /**
      * Conversation UUID. This field will be stored in client side storage to maintain the conversation session with server and will be used for next search request's ConversationalSearchRequest.conversation_id to restore conversation state in server.
      */
     conversationId?: string | null;
+    /**
+     * The conversational followup question generated for Intent refinement.
+     */
+    followupQuestion?: Schema$GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestion;
     /**
      * The proposed refined search queries. They can be used to fetch the relevant search results. When using CONVERSATIONAL_FILTER_ONLY mode, the refined_query from search response will be populated here.
      */
     refinedSearch?: Schema$GoogleCloudRetailV2alphaConversationalSearchResponseRefinedSearch[];
+    /**
+     * Output only. The state of the response generation.
+     */
+    state?: string | null;
+    /**
+     * The types Retail classifies the search query as. Supported values are: - "ADVERSARIAL" - "CHITCHAT" - "JAILBREAK" - "ORDER_SUPPORT" - "SIMPLE_PRODUCT_SEARCH" - "INTENT_REFINEMENT" - "PRODUCT_DETAILS" - "PRODUCT_COMPARISON" - "DEALS_AND_COUPONS" - "STORE_RELEVANT" - "BLOCKLISTED" - "BEST_PRODUCT" - "RETAIL_SUPPORT" - "DISABLED" clang-format off clang-format on
+     */
+    userQueryTypes?: string[] | null;
   }
   /**
    * This field specifies all related information that is needed on client side for UI rendering of conversational filtering search.
@@ -15897,7 +15913,11 @@ export namespace retail_v2alpha {
      *   // {
      *   //   "conversationId": "my_conversationId",
      *   //   "conversationalFilteringResult": {},
-     *   //   "refinedSearch": []
+     *   //   "conversationalTextResponse": "my_conversationalTextResponse",
+     *   //   "followupQuestion": {},
+     *   //   "refinedSearch": [],
+     *   //   "state": "my_state",
+     *   //   "userQueryTypes": []
      *   // }
      * }
      *
@@ -16652,7 +16672,11 @@ export namespace retail_v2alpha {
      *   // {
      *   //   "conversationId": "my_conversationId",
      *   //   "conversationalFilteringResult": {},
-     *   //   "refinedSearch": []
+     *   //   "conversationalTextResponse": "my_conversationalTextResponse",
+     *   //   "followupQuestion": {},
+     *   //   "refinedSearch": [],
+     *   //   "state": "my_state",
+     *   //   "userQueryTypes": []
      *   // }
      * }
      *