feat: release Control and ServingConfig serivces to v2 version (#319)

- [ ] Regenerate this pull request now.

feat: release AttributesConfig APIs to v2 version
feat: release CompletionConfig APIs to v2 version
feat: add local inventories info to the Product resource
docs: Improved documentation for Fullfillment and Inventory API in ProductService
docs: minor documentation format and typo fixes

PiperOrigin-RevId: 469399525

Source-Link: googleapis/googleapis@e9bcb6c

Source-Link: https://github.com/googleapis/googleapis-gen/commit/14169c645e64175b441d599cdb500c17f96441b2
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMTQxNjljNjQ1ZTY0MTc1YjQ0MWQ1OTljZGI1MDBjMTdmOTY0NDFiMiJ9

Author: gcf-owl-bot[bot]

generated_samples/generated_samples/retail_v2_generated_catalog_service_add_catalog_attribute_async.py

@@ -0,0 +1,49 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for AddCatalogAttribute
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-retail
+
+
+# [START retail_v2_generated_CatalogService_AddCatalogAttribute_async]
+from google.cloud import retail_v2
+
+
+async def sample_add_catalog_attribute():
+    # Create a client
+    client = retail_v2.CatalogServiceAsyncClient()
+
+    # Initialize request argument(s)
+    catalog_attribute = retail_v2.CatalogAttribute()
+    catalog_attribute.key = "key_value"
+
+    request = retail_v2.AddCatalogAttributeRequest(
+        attributes_config="attributes_config_value",
+        catalog_attribute=catalog_attribute,
+    )
+
+    # Make the request
+    response = await client.add_catalog_attribute(request=request)
+
+    # Handle the response
+    print(response)
+
+# [END retail_v2_generated_CatalogService_AddCatalogAttribute_async]

generated_samples/generated_samples/retail_v2_generated_catalog_service_add_catalog_attribute_sync.py

@@ -0,0 +1,49 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for AddCatalogAttribute
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-retail
+
+
+# [START retail_v2_generated_CatalogService_AddCatalogAttribute_sync]
+from google.cloud import retail_v2
+
+
+def sample_add_catalog_attribute():
+    # Create a client
+    client = retail_v2.CatalogServiceClient()
+
+    # Initialize request argument(s)
+    catalog_attribute = retail_v2.CatalogAttribute()
+    catalog_attribute.key = "key_value"
+
+    request = retail_v2.AddCatalogAttributeRequest(
+        attributes_config="attributes_config_value",
+        catalog_attribute=catalog_attribute,
+    )
+
+    # Make the request
+    response = client.add_catalog_attribute(request=request)
+
+    # Handle the response
+    print(response)
+
+# [END retail_v2_generated_CatalogService_AddCatalogAttribute_sync]

generated_samples/generated_samples/retail_v2_generated_catalog_service_get_attributes_config_async.py

@@ -0,0 +1,45 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for GetAttributesConfig
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-retail
+
+
+# [START retail_v2_generated_CatalogService_GetAttributesConfig_async]
+from google.cloud import retail_v2
+
+
+async def sample_get_attributes_config():
+    # Create a client
+    client = retail_v2.CatalogServiceAsyncClient()
+
+    # Initialize request argument(s)
+    request = retail_v2.GetAttributesConfigRequest(
+        name="name_value",
+    )
+
+    # Make the request
+    response = await client.get_attributes_config(request=request)
+
+    # Handle the response
+    print(response)
+
+# [END retail_v2_generated_CatalogService_GetAttributesConfig_async]

generated_samples/generated_samples/retail_v2_generated_catalog_service_get_attributes_config_sync.py

@@ -0,0 +1,45 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for GetAttributesConfig
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-retail
+
+
+# [START retail_v2_generated_CatalogService_GetAttributesConfig_sync]
+from google.cloud import retail_v2
+
+
+def sample_get_attributes_config():
+    # Create a client
+    client = retail_v2.CatalogServiceClient()
+
+    # Initialize request argument(s)
+    request = retail_v2.GetAttributesConfigRequest(
+        name="name_value",
+    )
+
+    # Make the request
+    response = client.get_attributes_config(request=request)
+
+    # Handle the response
+    print(response)
+
+# [END retail_v2_generated_CatalogService_GetAttributesConfig_sync]

generated_samples/generated_samples/retail_v2_generated_catalog_service_get_completion_config_async.py

@@ -0,0 +1,45 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for GetCompletionConfig
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-retail
+
+
+# [START retail_v2_generated_CatalogService_GetCompletionConfig_async]
+from google.cloud import retail_v2
+
+
+async def sample_get_completion_config():
+    # Create a client
+    client = retail_v2.CatalogServiceAsyncClient()
+
+    # Initialize request argument(s)
+    request = retail_v2.GetCompletionConfigRequest(
+        name="name_value",
+    )
+
+    # Make the request
+    response = await client.get_completion_config(request=request)
+
+    # Handle the response
+    print(response)
+
+# [END retail_v2_generated_CatalogService_GetCompletionConfig_async]

generated_samples/generated_samples/retail_v2_generated_catalog_service_get_completion_config_sync.py

@@ -0,0 +1,45 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for GetCompletionConfig
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-retail
+
+
+# [START retail_v2_generated_CatalogService_GetCompletionConfig_sync]
+from google.cloud import retail_v2
+
+
+def sample_get_completion_config():
+    # Create a client
+    client = retail_v2.CatalogServiceClient()
+
+    # Initialize request argument(s)
+    request = retail_v2.GetCompletionConfigRequest(
+        name="name_value",
+    )
+
+    # Make the request
+    response = client.get_completion_config(request=request)
+
+    # Handle the response
+    print(response)
+
+# [END retail_v2_generated_CatalogService_GetCompletionConfig_sync]

generated_samples/generated_samples/retail_v2_generated_catalog_service_remove_catalog_attribute_async.py

@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for RemoveCatalogAttribute
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-retail
+
+
+# [START retail_v2_generated_CatalogService_RemoveCatalogAttribute_async]
+from google.cloud import retail_v2
+
+
+async def sample_remove_catalog_attribute():
+    # Create a client
+    client = retail_v2.CatalogServiceAsyncClient()
+
+    # Initialize request argument(s)
+    request = retail_v2.RemoveCatalogAttributeRequest(
+        attributes_config="attributes_config_value",
+        key="key_value",
+    )
+
+    # Make the request
+    response = await client.remove_catalog_attribute(request=request)
+
+    # Handle the response
+    print(response)
+
+# [END retail_v2_generated_CatalogService_RemoveCatalogAttribute_async]

generated_samples/generated_samples/retail_v2_generated_catalog_service_remove_catalog_attribute_sync.py

@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 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.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for RemoveCatalogAttribute
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+#   python3 -m pip install google-cloud-retail
+
+
+# [START retail_v2_generated_CatalogService_RemoveCatalogAttribute_sync]
+from google.cloud import retail_v2
+
+
+def sample_remove_catalog_attribute():
+    # Create a client
+    client = retail_v2.CatalogServiceClient()
+
+    # Initialize request argument(s)
+    request = retail_v2.RemoveCatalogAttributeRequest(
+        attributes_config="attributes_config_value",
+        key="key_value",
+    )
+
+    # Make the request
+    response = client.remove_catalog_attribute(request=request)
+
+    # Handle the response
+    print(response)
+
+# [END retail_v2_generated_CatalogService_RemoveCatalogAttribute_sync]