docs: [google-cloud-retail] A comment for enum Mode is changed (#14368)

- [ ] Regenerate this pull request now.

BEGIN_COMMIT_OVERRIDE
docs: A comment for enum value `DISABLED` in enum `Mode` is changed
docs: A comment for enum value `ENABLED` in enum `Mode` is changed
docs: A comment for enum value `CONVERSATIONAL_FILTER_ONLY` in enum
`Mode` is changed
docs: A comment for field `user_query_types` in message
`.google.cloud.retail.v2alpha.ConversationalSearchResponse` is changed
docs: A comment for enum `Mode` is changed
feat: release the conversational search public SDK
END_COMMIT_OVERRIDE



PiperOrigin-RevId: 803633829

Source-Link:
googleapis/googleapis@46403a9

Source-Link:
googleapis/googleapis-gen@a130128
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXJldGFpbC8uT3dsQm90LnlhbWwiLCJoIjoiYTEzMDEyODgxNjFhNTc2ZWMxMThiODZhNjkwNjFhMDEzNWY2MTU2ZSJ9

BEGIN_NESTED_COMMIT
feat: [google-cloud-retail] release the latest conversational search
public SDK
PiperOrigin-RevId: 803623794

Source-Link:
googleapis/googleapis@6b27a50

Source-Link:
googleapis/googleapis-gen@3c29e6c
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXJldGFpbC8uT3dsQm90LnlhbWwiLCJoIjoiM2MyOWU2YzlhYzAxOWFlZWIyYTU1MGZkYTMxMjliZWQzZTE3ZmUyOCJ9
END_NESTED_COMMIT
BEGIN_NESTED_COMMIT
feat: [google-cloud-retail] release the conversational search public SDK
PiperOrigin-RevId: 803583303

Source-Link:
googleapis/googleapis@1f0e127

Source-Link:
googleapis/googleapis-gen@6ed3ac3
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXJldGFpbC8uT3dsQm90LnlhbWwiLCJoIjoiNmVkM2FjM2E5ZDY1ODJmNzZmZDc0ZGI1NTgwZTM2YWU3MmZhMDA5ZCJ9
END_NESTED_COMMIT

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-retail/docs/retail_v2/conversational_search_service.rst

@@ -0,0 +1,6 @@
+ConversationalSearchService
+---------------------------------------------
+
+.. automodule:: google.cloud.retail_v2.services.conversational_search_service
+    :members:
+    :inherited-members:

packages/google-cloud-retail/docs/retail_v2/services_.rst

@@ -7,6 +7,7 @@ Services for Google Cloud Retail v2 API
     catalog_service
     completion_service
     control_service
+    conversational_search_service
     generative_question_service
     model_service
     prediction_service

packages/google-cloud-retail/docs/retail_v2beta/conversational_search_service.rst

@@ -0,0 +1,6 @@
+ConversationalSearchService
+---------------------------------------------
+
+.. automodule:: google.cloud.retail_v2beta.services.conversational_search_service
+    :members:
+    :inherited-members:

packages/google-cloud-retail/docs/retail_v2beta/services_.rst

@@ -7,6 +7,7 @@ Services for Google Cloud Retail v2beta API
     catalog_service
     completion_service
     control_service
+    conversational_search_service
     generative_question_service
     model_service
     prediction_service

packages/google-cloud-retail/google/cloud/retail/__init__.py

@@ -38,6 +38,12 @@
     ControlServiceAsyncClient,
 )
 from google.cloud.retail_v2.services.control_service.client import ControlServiceClient
+from google.cloud.retail_v2.services.conversational_search_service.async_client import (
+    ConversationalSearchServiceAsyncClient,
+)
+from google.cloud.retail_v2.services.conversational_search_service.client import (
+    ConversationalSearchServiceClient,
+)
 from google.cloud.retail_v2.services.generative_question_service.async_client import (
     GenerativeQuestionServiceAsyncClient,
 )
@@ -130,6 +136,10 @@
     ListControlsResponse,
     UpdateControlRequest,
 )
+from google.cloud.retail_v2.types.conversational_search_service import (
+    ConversationalSearchRequest,
+    ConversationalSearchResponse,
+)
 from google.cloud.retail_v2.types.export_config import (
     BigQueryOutputResult,
     ExportAnalyticsMetricsRequest,
@@ -223,6 +233,7 @@
     PurgeUserEventsRequest,
     PurgeUserEventsResponse,
 )
+from google.cloud.retail_v2.types.safety import HarmCategory, SafetySetting
 from google.cloud.retail_v2.types.search_service import (
     ExperimentInfo,
     ProductAttributeInterval,
@@ -265,6 +276,8 @@
     "CompletionServiceAsyncClient",
     "ControlServiceClient",
     "ControlServiceAsyncClient",
+    "ConversationalSearchServiceClient",
+    "ConversationalSearchServiceAsyncClient",
     "GenerativeQuestionServiceClient",
     "GenerativeQuestionServiceAsyncClient",
     "ModelServiceClient",
@@ -325,6 +338,8 @@
     "ListControlsRequest",
     "ListControlsResponse",
     "UpdateControlRequest",
+    "ConversationalSearchRequest",
+    "ConversationalSearchResponse",
     "BigQueryOutputResult",
     "ExportAnalyticsMetricsRequest",
     "ExportAnalyticsMetricsResponse",
@@ -402,6 +417,8 @@
     "PurgeProductsResponse",
     "PurgeUserEventsRequest",
     "PurgeUserEventsResponse",
+    "SafetySetting",
+    "HarmCategory",
     "ExperimentInfo",
     "ProductAttributeInterval",
     "ProductAttributeValue",

packages/google-cloud-retail/google/cloud/retail_v2/__init__.py

@@ -28,6 +28,10 @@
     CompletionServiceClient,
 )
 from .services.control_service import ControlServiceAsyncClient, ControlServiceClient
+from .services.conversational_search_service import (
+    ConversationalSearchServiceAsyncClient,
+    ConversationalSearchServiceClient,
+)
 from .services.generative_question_service import (
     GenerativeQuestionServiceAsyncClient,
     GenerativeQuestionServiceClient,
@@ -100,6 +104,10 @@
     ListControlsResponse,
     UpdateControlRequest,
 )
+from .types.conversational_search_service import (
+    ConversationalSearchRequest,
+    ConversationalSearchResponse,
+)
 from .types.export_config import (
     BigQueryOutputResult,
     ExportAnalyticsMetricsRequest,
@@ -190,6 +198,7 @@
     PurgeUserEventsRequest,
     PurgeUserEventsResponse,
 )
+from .types.safety import HarmCategory, SafetySetting
 from .types.search_service import (
     ExperimentInfo,
     ProductAttributeInterval,
@@ -228,6 +237,7 @@
     "CatalogServiceAsyncClient",
     "CompletionServiceAsyncClient",
     "ControlServiceAsyncClient",
+    "ConversationalSearchServiceAsyncClient",
     "GenerativeQuestionServiceAsyncClient",
     "ModelServiceAsyncClient",
     "PredictionServiceAsyncClient",
@@ -265,6 +275,9 @@
     "Condition",
     "Control",
     "ControlServiceClient",
+    "ConversationalSearchRequest",
+    "ConversationalSearchResponse",
+    "ConversationalSearchServiceClient",
     "CreateControlRequest",
     "CreateModelMetadata",
     "CreateModelRequest",
@@ -296,6 +309,7 @@
     "GetModelRequest",
     "GetProductRequest",
     "GetServingConfigRequest",
+    "HarmCategory",
     "Image",
     "ImportCompletionDataRequest",
     "ImportCompletionDataResponse",
@@ -361,6 +375,7 @@
     "ReplaceCatalogAttributeRequest",
     "ResumeModelRequest",
     "Rule",
+    "SafetySetting",
     "SearchRequest",
     "SearchResponse",
     "SearchServiceClient",

packages/google-cloud-retail/google/cloud/retail_v2/gapic_metadata.json

@@ -366,6 +366,40 @@
         }
       }
     },
+    "ConversationalSearchService": {
+      "clients": {
+        "grpc": {
+          "libraryClient": "ConversationalSearchServiceClient",
+          "rpcs": {
+            "ConversationalSearch": {
+              "methods": [
+                "conversational_search"
+              ]
+            }
+          }
+        },
+        "grpc-async": {
+          "libraryClient": "ConversationalSearchServiceAsyncClient",
+          "rpcs": {
+            "ConversationalSearch": {
+              "methods": [
+                "conversational_search"
+              ]
+            }
+          }
+        },
+        "rest": {
+          "libraryClient": "ConversationalSearchServiceClient",
+          "rpcs": {
+            "ConversationalSearch": {
+              "methods": [
+                "conversational_search"
+              ]
+            }
+          }
+        }
+      }
+    },
     "GenerativeQuestionService": {
       "clients": {
         "grpc": {

packages/google-cloud-retail/google/cloud/retail_v2/services/conversational_search_service/__init__.py

@@ -0,0 +1,22 @@
+# -*- coding: utf-8 -*-
+# Copyright 2025 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+from .async_client import ConversationalSearchServiceAsyncClient
+from .client import ConversationalSearchServiceClient
+
+__all__ = (
+    "ConversationalSearchServiceClient",
+    "ConversationalSearchServiceAsyncClient",
+)