feat: Automated regeneration of Retail client (#13167)

Auto-created at 2025-03-15 13:14:48 +0000 using the toys pull request generator.

Author: yoshi-code-bot

clients/retail/lib/google_api/retail/v2/api/projects.ex

@@ -51,7 +51,7 @@ defmodule GoogleApi.Retail.V2.Api.Projects do
       *   `:languageCodes` (*type:* `list(String.t)`) - Note that this field applies for `user-data` dataset only. For requests with `cloud-retail` dataset, setting this field has no effect. The language filters applied to the output suggestions. If set, it should contain the language of the query. If not set, suggestions are returned without considering language restrictions. This is the BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3.
       *   `:maxSuggestions` (*type:* `integer()`) - Completion max suggestions. If left unset or set to 0, then will fallback to the configured value CompletionConfig.max_suggestions. The maximum allowed max suggestions is 20. If it is set higher, it will be capped by 20.
       *   `:query` (*type:* `String.t`) - Required. The query used to generate suggestions. The maximum number of allowed characters is 255.
-      *   `:visitorId` (*type:* `String.t`) - Required field. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.
+      *   `:visitorId` (*type:* `String.t`) - Recommended field. A unique identifier for tracking visitors. For example, this could be implemented with an HTTP cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor logs in or out of the website. The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.
   *   `opts` (*type:* `keyword()`) - Call options
 
   ## Returns

clients/retail/lib/google_api/retail/v2/metadata.ex

@@ -20,7 +20,7 @@ defmodule GoogleApi.Retail.V2 do
   API client metadata for GoogleApi.Retail.V2.
   """
 
-  @discovery_revision "20250227"
+  @discovery_revision "20250314"
 
   def discovery_revision(), do: @discovery_revision
 end

clients/retail/lib/google_api/retail/v2/model/google_cloud_retail_v2_search_request.ex

@@ -37,6 +37,7 @@ defmodule GoogleApi.Retail.V2.Model.GoogleCloudRetailV2SearchRequest do
   *   `pageSize` (*type:* `integer()`, *default:* `nil`) - Maximum number of Products to return. If unspecified, defaults to a reasonable value. The maximum allowed value is 120. Values above 120 will be coerced to 120. If this field is negative, an INVALID_ARGUMENT is returned.
   *   `pageToken` (*type:* `String.t`, *default:* `nil`) - A page token SearchResponse.next_page_token, received from a previous SearchService.Search call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to SearchService.Search must match the call that provided the page token. Otherwise, an INVALID_ARGUMENT error is returned.
   *   `personalizationSpec` (*type:* `GoogleApi.Retail.V2.Model.GoogleCloudRetailV2SearchRequestPersonalizationSpec.t`, *default:* `nil`) - The specification for personalization. Notice that if both ServingConfig.personalization_spec and SearchRequest.personalization_spec are set. SearchRequest.personalization_spec will override ServingConfig.personalization_spec.
+  *   `placeId` (*type:* `String.t`, *default:* `nil`) - Optional. An id corresponding to a place, such as a store id or region id. When specified, we use the price from the local inventory with the matching product's LocalInventory.place_id for revenue optimization.
   *   `query` (*type:* `String.t`, *default:* `nil`) - Raw search query. If this field is empty, the request is considered a category browsing request and returned results are based on filter and page_categories.
   *   `queryExpansionSpec` (*type:* `GoogleApi.Retail.V2.Model.GoogleCloudRetailV2SearchRequestQueryExpansionSpec.t`, *default:* `nil`) - The query expansion specification that specifies the conditions under which query expansion occurs. For more information, see [Query expansion](https://cloud.google.com/retail/docs/result-size#query_expansion).
   *   `regionCode` (*type:* `String.t`, *default:* `nil`) - Optional. The Unicode country/region code (CLDR) of a location, such as "US" and "419" [list](https://www.unicode.org/cldr/charts/46/supplemental/territory_information.html). For more information, see [Standardized codes](https://google.aip.dev/143). If set, then results will be boosted based on the region_code provided.
@@ -74,6 +75,7 @@ defmodule GoogleApi.Retail.V2.Model.GoogleCloudRetailV2SearchRequest do
           :personalizationSpec =>
             GoogleApi.Retail.V2.Model.GoogleCloudRetailV2SearchRequestPersonalizationSpec.t()
             | nil,
+          :placeId => String.t() | nil,
           :query => String.t() | nil,
           :queryExpansionSpec =>
             GoogleApi.Retail.V2.Model.GoogleCloudRetailV2SearchRequestQueryExpansionSpec.t() | nil,
@@ -121,6 +123,7 @@ defmodule GoogleApi.Retail.V2.Model.GoogleCloudRetailV2SearchRequest do
     as: GoogleApi.Retail.V2.Model.GoogleCloudRetailV2SearchRequestPersonalizationSpec
   )
 
+  field(:placeId)
   field(:query)
 
   field(:queryExpansionSpec,