feat: [google-cloud-retail] add availability field to Localnventory (googleapis#13821)

- [ ] Regenerate this pull request now.

BEGIN_COMMIT_OVERRIDE

feat: add availability field to Localnventory
feat: add new fields including language_code, region_code and place_id
to SearchRequest.
feat: add pin_control_metadata to SearchResponse.
fix!: An existing message `LlmEmbeddingConfig` is removed.
fix!: An existing field `llm_embedding_config` is removed from message
`.google.cloud.retail.v2alpha.Model`
docs: keep the API doc up-to-date with recent changes

END_COMMIT_OVERRIDE


feat: add new fields including language_code, region_code and place_id
to SearchRequest.
feat: add pin_control_metadata to SearchResponse.
fix!: An existing message `LlmEmbeddingConfig` is removed.
fix!: An existing field `llm_embedding_config` is removed from message
`.google.cloud.retail.v2alpha.Model`
docs: keep the API doc up-to-date with recent changes

PiperOrigin-RevId: 750240703

Source-Link:
googleapis/googleapis@1422653

Source-Link:
https://github.com/googleapis/googleapis-gen/commit/b6760bcda5f33e4e27e6e6a68d9e83f708b7516a
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXJldGFpbC8uT3dsQm90LnlhbWwiLCJoIjoiYjY3NjBiY2RhNWYzM2U0ZTI3ZTZlNmE2OGQ5ZTgzZjcwOGI3NTE2YSJ9

---------

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

Author: gcf-owl-bot[bot]

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

@@ -96,6 +96,7 @@
     Image,
     Interval,
     LocalInventory,
+    PinControlMetadata,
     PriceInfo,
     Rating,
     RecommendationsFilteringOption,
@@ -402,6 +403,7 @@
     "OutputConfig",
     "OutputResult",
     "PauseModelRequest",
+    "PinControlMetadata",
     "PredictRequest",
     "PredictResponse",
     "PredictionServiceClient",

packages/google-cloud-retail/google/cloud/retail_v2alpha/services/user_event_service/async_client.py

@@ -409,9 +409,11 @@ async def collect_user_event(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
     ) -> httpbody_pb2.HttpBody:
-        r"""Writes a single user event from the browser. This
-        uses a GET request to due to browser restriction of
-        POST-ing to a 3rd party domain.
+        r"""Writes a single user event from the browser.
+
+        For larger user event payload over 16 KB, the POST
+        method should be used instead, otherwise a 400 Bad
+        Request error is returned.
 
         This method is used only by the Retail API JavaScript
         pixel and Google Tag Manager. Users should not call this

packages/google-cloud-retail/google/cloud/retail_v2alpha/services/user_event_service/client.py

@@ -855,9 +855,11 @@ def collect_user_event(
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
         metadata: Sequence[Tuple[str, Union[str, bytes]]] = (),
     ) -> httpbody_pb2.HttpBody:
-        r"""Writes a single user event from the browser. This
-        uses a GET request to due to browser restriction of
-        POST-ing to a 3rd party domain.
+        r"""Writes a single user event from the browser.
+
+        For larger user event payload over 16 KB, the POST
+        method should be used instead, otherwise a 400 Bad
+        Request error is returned.
 
         This method is used only by the Retail API JavaScript
         pixel and Google Tag Manager. Users should not call this

packages/google-cloud-retail/google/cloud/retail_v2alpha/services/user_event_service/transports/grpc.py

@@ -378,9 +378,11 @@ def collect_user_event(
     ) -> Callable[[user_event_service.CollectUserEventRequest], httpbody_pb2.HttpBody]:
         r"""Return a callable for the collect user event method over gRPC.
 
-        Writes a single user event from the browser. This
-        uses a GET request to due to browser restriction of
-        POST-ing to a 3rd party domain.
+        Writes a single user event from the browser.
+
+        For larger user event payload over 16 KB, the POST
+        method should be used instead, otherwise a 400 Bad
+        Request error is returned.
 
         This method is used only by the Retail API JavaScript
         pixel and Google Tag Manager. Users should not call this

packages/google-cloud-retail/google/cloud/retail_v2alpha/services/user_event_service/transports/grpc_asyncio.py

@@ -390,9 +390,11 @@ def collect_user_event(
     ]:
         r"""Return a callable for the collect user event method over gRPC.
 
-        Writes a single user event from the browser. This
-        uses a GET request to due to browser restriction of
-        POST-ing to a 3rd party domain.
+        Writes a single user event from the browser.
+
+        For larger user event payload over 16 KB, the POST
+        method should be used instead, otherwise a 400 Bad
+        Request error is returned.
 
         This method is used only by the Retail API JavaScript
         pixel and Google Tag Manager. Users should not call this

packages/google-cloud-retail/google/cloud/retail_v2alpha/services/user_event_service/transports/rest_base.py

@@ -119,6 +119,11 @@ def _get_http_options():
                     "method": "get",
                     "uri": "/v2alpha/{parent=projects/*/locations/*/catalogs/*}/userEvents:collect",
                 },
+                {
+                    "method": "post",
+                    "uri": "/v2alpha/{parent=projects/*/locations/*/catalogs/*}/userEvents:collect",
+                    "body": "*",
+                },
             ]
             return http_options
 

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

@@ -52,6 +52,7 @@
     Image,
     Interval,
     LocalInventory,
+    PinControlMetadata,
     PriceInfo,
     Rating,
     RecommendationsFilteringOption,
@@ -254,6 +255,7 @@
     "Image",
     "Interval",
     "LocalInventory",
+    "PinControlMetadata",
     "PriceInfo",
     "Rating",
     "Rule",

packages/google-cloud-retail/google/cloud/retail_v2alpha/types/catalog.py

@@ -138,8 +138,7 @@ class CatalogAttribute(proto.Message):
 
             [CatalogAttribute][google.cloud.retail.v2alpha.CatalogAttribute]
             can be pre-loaded by using
-            [CatalogService.AddCatalogAttribute][google.cloud.retail.v2alpha.CatalogService.AddCatalogAttribute],
-            [CatalogService.ImportCatalogAttributes][google.cloud.retail.v2alpha.CatalogService.ImportCatalogAttributes],
+            [CatalogService.AddCatalogAttribute][google.cloud.retail.v2alpha.CatalogService.AddCatalogAttribute]
             or
             [CatalogService.UpdateAttributesConfig][google.cloud.retail.v2alpha.CatalogService.UpdateAttributesConfig]
             APIs. This field is ``False`` for pre-loaded