feat(retail): update the api

#### retail:v2

The following keys were added:
- schemas.GoogleCloudRetailV2SearchRequest.properties.placeId.type (Total Keys: 1)

#### retail:v2alpha

The following keys were added:
- resources.projects.resources.locations.resources.catalogs.resources.placements.methods.conversationalSearch (Total Keys: 12)
- resources.projects.resources.locations.resources.catalogs.resources.servingConfigs.methods.conversationalSearch (Total Keys: 12)
- schemas.GoogleCloudRetailV2alphaConversationalSearchRequest (Total Keys: 30)
- schemas.GoogleCloudRetailV2alphaConversationalSearchResponse (Total Keys: 26)
- schemas.GoogleCloudRetailV2alphaSearchRequest.properties.placeId.type (Total Keys: 1)

#### retail:v2beta

The following keys were added:
- schemas.GoogleCloudRetailV2betaSearchRequest.properties.placeId.type (Total Keys: 1)

Author: yoshi-automation

docs/dyn/retail_v2.projects.locations.catalogs.html

@@ -193,7 +193,7 @@ <h3>Method Details</h3>
   languageCodes: string, 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 &quot;en-US&quot; or &quot;sr-Latn&quot;. For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3. (repeated)
   maxSuggestions: 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: string, Required. The query used to generate suggestions. The maximum number of allowed characters is 255.
-  visitorId: string, 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: string, 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.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format

docs/dyn/retail_v2.projects.locations.catalogs.placements.html

@@ -453,6 +453,7 @@ <h3>Method Details</h3>
   &quot;personalizationSpec&quot;: { # The specification for personalization. # 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.
     &quot;mode&quot;: &quot;A String&quot;, # Defaults to Mode.AUTO.
   },
+  &quot;placeId&quot;: &quot;A String&quot;, # 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&#x27;s LocalInventory.place_id for revenue optimization.
   &quot;query&quot;: &quot;A String&quot;, # 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.
   &quot;queryExpansionSpec&quot;: { # Specification to determine under which conditions query expansion should occur. # 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).
     &quot;condition&quot;: &quot;A String&quot;, # The condition under which query expansion should occur. Default to Condition.DISABLED.

docs/dyn/retail_v2.projects.locations.catalogs.servingConfigs.html

@@ -1004,6 +1004,7 @@ <h3>Method Details</h3>
   &quot;personalizationSpec&quot;: { # The specification for personalization. # 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.
     &quot;mode&quot;: &quot;A String&quot;, # Defaults to Mode.AUTO.
   },
+  &quot;placeId&quot;: &quot;A String&quot;, # 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&#x27;s LocalInventory.place_id for revenue optimization.
   &quot;query&quot;: &quot;A String&quot;, # 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.
   &quot;queryExpansionSpec&quot;: { # Specification to determine under which conditions query expansion should occur. # 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).
     &quot;condition&quot;: &quot;A String&quot;, # The condition under which query expansion should occur. Default to Condition.DISABLED.

docs/dyn/retail_v2alpha.projects.locations.catalogs.html

@@ -198,7 +198,7 @@ <h3>Method Details</h3>
   languageCodes: string, 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 &quot;en-US&quot; or &quot;sr-Latn&quot;. For more information, see [Tags for Identifying Languages](https://tools.ietf.org/html/bcp47). The maximum number of language codes is 3. (repeated)
   maxSuggestions: 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: string, Required. The query used to generate suggestions. The maximum number of allowed characters is 255.
-  visitorId: string, 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: string, 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.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format