feat: add conversational search

feat: add tile navigation
docs: keep the API doc up-to-date with recent changes

PiperOrigin-RevId: 683821686

Source-Link: googleapis/googleapis@d01eb46

Source-Link: googleapis/googleapis-gen@1db3459
Copy-Tag: eyJwIjoiYXBpcy9Hb29nbGUuQ2xvdWQuUmV0YWlsLlYyLy5Pd2xCb3QueWFtbCIsImgiOiIxZGIzNDU5ZjNkZmE5MzQ3YTU4MTFkNzJiMTJlMTcxNGRhNzVlZDkzIn0=

apis/Google.Cloud.Retail.V2/Google.Cloud.Retail.V2.GeneratedSnippets/GenerativeQuestionServiceClient.BatchUpdateGenerativeQuestionConfigsAsyncSnippet.g.cs

@@ -0,0 +1,49 @@
+// Copyright 2024 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START retail_v2_generated_GenerativeQuestionService_BatchUpdateGenerativeQuestionConfigs_async_flattened]
+    using Google.Cloud.Retail.V2;
+    using System.Collections.Generic;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedGenerativeQuestionServiceClientSnippets
+    {
+        /// <summary>Snippet for BatchUpdateGenerativeQuestionConfigsAsync</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public async Task BatchUpdateGenerativeQuestionConfigsAsync()
+        {
+            // Create client
+            GenerativeQuestionServiceClient generativeQuestionServiceClient = await GenerativeQuestionServiceClient.CreateAsync();
+            // Initialize request argument(s)
+            string parent = "projects/[PROJECT]/locations/[LOCATION]/catalogs/[CATALOG]";
+            IEnumerable<UpdateGenerativeQuestionConfigRequest> requests = new UpdateGenerativeQuestionConfigRequest[]
+            {
+                new UpdateGenerativeQuestionConfigRequest(),
+            };
+            // Make the request
+            BatchUpdateGenerativeQuestionConfigsResponse response = await generativeQuestionServiceClient.BatchUpdateGenerativeQuestionConfigsAsync(parent, requests);
+        }
+    }
+    // [END retail_v2_generated_GenerativeQuestionService_BatchUpdateGenerativeQuestionConfigs_async_flattened]
+}

apis/Google.Cloud.Retail.V2/Google.Cloud.Retail.V2.GeneratedSnippets/GenerativeQuestionServiceClient.BatchUpdateGenerativeQuestionConfigsRequestObjectAsyncSnippet.g.cs

@@ -0,0 +1,51 @@
+// Copyright 2024 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START retail_v2_generated_GenerativeQuestionService_BatchUpdateGenerativeQuestionConfigs_async]
+    using Google.Cloud.Retail.V2;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedGenerativeQuestionServiceClientSnippets
+    {
+        /// <summary>Snippet for BatchUpdateGenerativeQuestionConfigsAsync</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public async Task BatchUpdateGenerativeQuestionConfigsRequestObjectAsync()
+        {
+            // Create client
+            GenerativeQuestionServiceClient generativeQuestionServiceClient = await GenerativeQuestionServiceClient.CreateAsync();
+            // Initialize request argument(s)
+            BatchUpdateGenerativeQuestionConfigsRequest request = new BatchUpdateGenerativeQuestionConfigsRequest
+            {
+                ParentAsCatalogName = CatalogName.FromProjectLocationCatalog("[PROJECT]", "[LOCATION]", "[CATALOG]"),
+                Requests =
+                {
+                    new UpdateGenerativeQuestionConfigRequest(),
+                },
+            };
+            // Make the request
+            BatchUpdateGenerativeQuestionConfigsResponse response = await generativeQuestionServiceClient.BatchUpdateGenerativeQuestionConfigsAsync(request);
+        }
+    }
+    // [END retail_v2_generated_GenerativeQuestionService_BatchUpdateGenerativeQuestionConfigs_async]
+}

apis/Google.Cloud.Retail.V2/Google.Cloud.Retail.V2.GeneratedSnippets/GenerativeQuestionServiceClient.BatchUpdateGenerativeQuestionConfigsRequestObjectSnippet.g.cs

@@ -0,0 +1,50 @@
+// Copyright 2024 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START retail_v2_generated_GenerativeQuestionService_BatchUpdateGenerativeQuestionConfigs_sync]
+    using Google.Cloud.Retail.V2;
+
+    public sealed partial class GeneratedGenerativeQuestionServiceClientSnippets
+    {
+        /// <summary>Snippet for BatchUpdateGenerativeQuestionConfigs</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public void BatchUpdateGenerativeQuestionConfigsRequestObject()
+        {
+            // Create client
+            GenerativeQuestionServiceClient generativeQuestionServiceClient = GenerativeQuestionServiceClient.Create();
+            // Initialize request argument(s)
+            BatchUpdateGenerativeQuestionConfigsRequest request = new BatchUpdateGenerativeQuestionConfigsRequest
+            {
+                ParentAsCatalogName = CatalogName.FromProjectLocationCatalog("[PROJECT]", "[LOCATION]", "[CATALOG]"),
+                Requests =
+                {
+                    new UpdateGenerativeQuestionConfigRequest(),
+                },
+            };
+            // Make the request
+            BatchUpdateGenerativeQuestionConfigsResponse response = generativeQuestionServiceClient.BatchUpdateGenerativeQuestionConfigs(request);
+        }
+    }
+    // [END retail_v2_generated_GenerativeQuestionService_BatchUpdateGenerativeQuestionConfigs_sync]
+}

apis/Google.Cloud.Retail.V2/Google.Cloud.Retail.V2.GeneratedSnippets/GenerativeQuestionServiceClient.BatchUpdateGenerativeQuestionConfigsResourceNamesAsyncSnippet.g.cs

@@ -0,0 +1,49 @@
+// Copyright 2024 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START retail_v2_generated_GenerativeQuestionService_BatchUpdateGenerativeQuestionConfigs_async_flattened_resourceNames]
+    using Google.Cloud.Retail.V2;
+    using System.Collections.Generic;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedGenerativeQuestionServiceClientSnippets
+    {
+        /// <summary>Snippet for BatchUpdateGenerativeQuestionConfigsAsync</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public async Task BatchUpdateGenerativeQuestionConfigsResourceNamesAsync()
+        {
+            // Create client
+            GenerativeQuestionServiceClient generativeQuestionServiceClient = await GenerativeQuestionServiceClient.CreateAsync();
+            // Initialize request argument(s)
+            CatalogName parent = CatalogName.FromProjectLocationCatalog("[PROJECT]", "[LOCATION]", "[CATALOG]");
+            IEnumerable<UpdateGenerativeQuestionConfigRequest> requests = new UpdateGenerativeQuestionConfigRequest[]
+            {
+                new UpdateGenerativeQuestionConfigRequest(),
+            };
+            // Make the request
+            BatchUpdateGenerativeQuestionConfigsResponse response = await generativeQuestionServiceClient.BatchUpdateGenerativeQuestionConfigsAsync(parent, requests);
+        }
+    }
+    // [END retail_v2_generated_GenerativeQuestionService_BatchUpdateGenerativeQuestionConfigs_async_flattened_resourceNames]
+}

apis/Google.Cloud.Retail.V2/Google.Cloud.Retail.V2.GeneratedSnippets/GenerativeQuestionServiceClient.BatchUpdateGenerativeQuestionConfigsResourceNamesSnippet.g.cs

@@ -0,0 +1,48 @@
+// Copyright 2024 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START retail_v2_generated_GenerativeQuestionService_BatchUpdateGenerativeQuestionConfigs_sync_flattened_resourceNames]
+    using Google.Cloud.Retail.V2;
+    using System.Collections.Generic;
+
+    public sealed partial class GeneratedGenerativeQuestionServiceClientSnippets
+    {
+        /// <summary>Snippet for BatchUpdateGenerativeQuestionConfigs</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public void BatchUpdateGenerativeQuestionConfigsResourceNames()
+        {
+            // Create client
+            GenerativeQuestionServiceClient generativeQuestionServiceClient = GenerativeQuestionServiceClient.Create();
+            // Initialize request argument(s)
+            CatalogName parent = CatalogName.FromProjectLocationCatalog("[PROJECT]", "[LOCATION]", "[CATALOG]");
+            IEnumerable<UpdateGenerativeQuestionConfigRequest> requests = new UpdateGenerativeQuestionConfigRequest[]
+            {
+                new UpdateGenerativeQuestionConfigRequest(),
+            };
+            // Make the request
+            BatchUpdateGenerativeQuestionConfigsResponse response = generativeQuestionServiceClient.BatchUpdateGenerativeQuestionConfigs(parent, requests);
+        }
+    }
+    // [END retail_v2_generated_GenerativeQuestionService_BatchUpdateGenerativeQuestionConfigs_sync_flattened_resourceNames]
+}

apis/Google.Cloud.Retail.V2/Google.Cloud.Retail.V2.GeneratedSnippets/GenerativeQuestionServiceClient.BatchUpdateGenerativeQuestionConfigsSnippet.g.cs

@@ -0,0 +1,48 @@
+// Copyright 2024 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START retail_v2_generated_GenerativeQuestionService_BatchUpdateGenerativeQuestionConfigs_sync_flattened]
+    using Google.Cloud.Retail.V2;
+    using System.Collections.Generic;
+
+    public sealed partial class GeneratedGenerativeQuestionServiceClientSnippets
+    {
+        /// <summary>Snippet for BatchUpdateGenerativeQuestionConfigs</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public void BatchUpdateGenerativeQuestionConfigs()
+        {
+            // Create client
+            GenerativeQuestionServiceClient generativeQuestionServiceClient = GenerativeQuestionServiceClient.Create();
+            // Initialize request argument(s)
+            string parent = "projects/[PROJECT]/locations/[LOCATION]/catalogs/[CATALOG]";
+            IEnumerable<UpdateGenerativeQuestionConfigRequest> requests = new UpdateGenerativeQuestionConfigRequest[]
+            {
+                new UpdateGenerativeQuestionConfigRequest(),
+            };
+            // Make the request
+            BatchUpdateGenerativeQuestionConfigsResponse response = generativeQuestionServiceClient.BatchUpdateGenerativeQuestionConfigs(parent, requests);
+        }
+    }
+    // [END retail_v2_generated_GenerativeQuestionService_BatchUpdateGenerativeQuestionConfigs_sync_flattened]
+}

apis/Google.Cloud.Retail.V2/Google.Cloud.Retail.V2.GeneratedSnippets/GenerativeQuestionServiceClient.GetGenerativeQuestionsFeatureConfigAsyncSnippet.g.cs

@@ -0,0 +1,44 @@
+// Copyright 2024 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START retail_v2_generated_GenerativeQuestionService_GetGenerativeQuestionsFeatureConfig_async_flattened]
+    using Google.Cloud.Retail.V2;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedGenerativeQuestionServiceClientSnippets
+    {
+        /// <summary>Snippet for GetGenerativeQuestionsFeatureConfigAsync</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public async Task GetGenerativeQuestionsFeatureConfigAsync()
+        {
+            // Create client
+            GenerativeQuestionServiceClient generativeQuestionServiceClient = await GenerativeQuestionServiceClient.CreateAsync();
+            // Initialize request argument(s)
+            string catalog = "projects/[PROJECT]/locations/[LOCATION]/catalogs/[CATALOG]";
+            // Make the request
+            GenerativeQuestionsFeatureConfig response = await generativeQuestionServiceClient.GetGenerativeQuestionsFeatureConfigAsync(catalog);
+        }
+    }
+    // [END retail_v2_generated_GenerativeQuestionService_GetGenerativeQuestionsFeatureConfig_async_flattened]
+}

apis/Google.Cloud.Retail.V2/Google.Cloud.Retail.V2.GeneratedSnippets/GenerativeQuestionServiceClient.GetGenerativeQuestionsFeatureConfigRequestObjectAsyncSnippet.g.cs

@@ -0,0 +1,47 @@
+// Copyright 2024 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START retail_v2_generated_GenerativeQuestionService_GetGenerativeQuestionsFeatureConfig_async]
+    using Google.Cloud.Retail.V2;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedGenerativeQuestionServiceClientSnippets
+    {
+        /// <summary>Snippet for GetGenerativeQuestionsFeatureConfigAsync</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public async Task GetGenerativeQuestionsFeatureConfigRequestObjectAsync()
+        {
+            // Create client
+            GenerativeQuestionServiceClient generativeQuestionServiceClient = await GenerativeQuestionServiceClient.CreateAsync();
+            // Initialize request argument(s)
+            GetGenerativeQuestionsFeatureConfigRequest request = new GetGenerativeQuestionsFeatureConfigRequest
+            {
+                CatalogAsCatalogName = CatalogName.FromProjectLocationCatalog("[PROJECT]", "[LOCATION]", "[CATALOG]"),
+            };
+            // Make the request
+            GenerativeQuestionsFeatureConfig response = await generativeQuestionServiceClient.GetGenerativeQuestionsFeatureConfigAsync(request);
+        }
+    }
+    // [END retail_v2_generated_GenerativeQuestionService_GetGenerativeQuestionsFeatureConfig_async]
+}