feat(retail): update the api

#### retail:v2alpha

The following keys were added:
- schemas.GoogleCloudRetailV2alphaSearchRequest.properties.userAttributes (Total Keys: 2)
- schemas.GoogleCloudRetailV2alphaStringList (Total Keys: 4)

Author: yoshi-automation

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

@@ -167,7 +167,7 @@ <h3>Method Details</h3>
     &quot;followupQuestion&quot;: { # The conversational followup question generated for Intent refinement. # The conversational filtering question.
       &quot;followupQuestion&quot;: &quot;A String&quot;, # The conversational followup question generated for Intent refinement.
       &quot;suggestedAnswers&quot;: [ # The answer options provided to client for the follow-up question.
-        { # Suggested answers to the follow-up question.
+        { # Suggested answers to the follow-up question. If it&#x27;s numerical attribute, only ProductAttributeInterval will be set. If it&#x27;s textual attribute, only productAttributeValue will be set.
           &quot;productAttributeValue&quot;: { # Product attribute which structured by an attribute name and value. This structure is used in conversational search filters and answers. For example, if we have `name=color` and `value=red`, this means that the color is `red`. # Product attribute value, including an attribute key and an attribute value. Other types can be added here in the future.
             &quot;name&quot;: &quot;A String&quot;, # The attribute name.
             &quot;value&quot;: &quot;A String&quot;, # The attribute value.
@@ -578,6 +578,13 @@ <h3>Method Details</h3>
     ],
     &quot;tileNavigationRequested&quot;: True or False, # This field specifies whether the customer would like to request tile navigation.
   },
+  &quot;userAttributes&quot;: { # Optional. The user attributes that could be used for personalization of search results. * Populate at most 100 key-value pairs per query. * Only supports string keys and repeated string values. * Duplcate keys are not allowed within a single query. Example: user_attributes: [ { key: &quot;pets&quot; value { values: &quot;dog&quot; values: &quot;cat&quot; } }, { key: &quot;state&quot; value { values: &quot;CA&quot; } } ]
+    &quot;a_key&quot;: { # A list of string values.
+      &quot;values&quot;: [ # String values.
+        &quot;A String&quot;,
+      ],
+    },
+  },
   &quot;userInfo&quot;: { # Information of an end user. # User information.
     &quot;directUserRequest&quot;: True or False, # True if the request is made directly from the end user, in which case the ip_address and user_agent can be populated from the HTTP request. This flag should be set only if the API request is made directly from the end user such as a mobile app (and not if a gateway or a server is processing and pushing the user events). This should not be set when using the JavaScript tag in UserEventService.CollectUserEvent.
     &quot;ipAddress&quot;: &quot;A String&quot;, # The end user&#x27;s IP address. This field is used to extract location information for personalization. This field must be either an IPv4 address (e.g. &quot;104.133.9.80&quot;) or an IPv6 address (e.g. &quot;2001:0db8:85a3:0000:0000:8a2e:0370:7334&quot;). Otherwise, an INVALID_ARGUMENT error is returned. This should not be set when: * setting SearchRequest.user_info. * using the JavaScript tag in UserEventService.CollectUserEvent or if direct_user_request is set.

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

@@ -260,7 +260,7 @@ <h3>Method Details</h3>
     &quot;followupQuestion&quot;: { # The conversational followup question generated for Intent refinement. # The conversational filtering question.
       &quot;followupQuestion&quot;: &quot;A String&quot;, # The conversational followup question generated for Intent refinement.
       &quot;suggestedAnswers&quot;: [ # The answer options provided to client for the follow-up question.
-        { # Suggested answers to the follow-up question.
+        { # Suggested answers to the follow-up question. If it&#x27;s numerical attribute, only ProductAttributeInterval will be set. If it&#x27;s textual attribute, only productAttributeValue will be set.
           &quot;productAttributeValue&quot;: { # Product attribute which structured by an attribute name and value. This structure is used in conversational search filters and answers. For example, if we have `name=color` and `value=red`, this means that the color is `red`. # Product attribute value, including an attribute key and an attribute value. Other types can be added here in the future.
             &quot;name&quot;: &quot;A String&quot;, # The attribute name.
             &quot;value&quot;: &quot;A String&quot;, # The attribute value.
@@ -1129,6 +1129,13 @@ <h3>Method Details</h3>
     ],
     &quot;tileNavigationRequested&quot;: True or False, # This field specifies whether the customer would like to request tile navigation.
   },
+  &quot;userAttributes&quot;: { # Optional. The user attributes that could be used for personalization of search results. * Populate at most 100 key-value pairs per query. * Only supports string keys and repeated string values. * Duplcate keys are not allowed within a single query. Example: user_attributes: [ { key: &quot;pets&quot; value { values: &quot;dog&quot; values: &quot;cat&quot; } }, { key: &quot;state&quot; value { values: &quot;CA&quot; } } ]
+    &quot;a_key&quot;: { # A list of string values.
+      &quot;values&quot;: [ # String values.
+        &quot;A String&quot;,
+      ],
+    },
+  },
   &quot;userInfo&quot;: { # Information of an end user. # User information.
     &quot;directUserRequest&quot;: True or False, # True if the request is made directly from the end user, in which case the ip_address and user_agent can be populated from the HTTP request. This flag should be set only if the API request is made directly from the end user such as a mobile app (and not if a gateway or a server is processing and pushing the user events). This should not be set when using the JavaScript tag in UserEventService.CollectUserEvent.
     &quot;ipAddress&quot;: &quot;A String&quot;, # The end user&#x27;s IP address. This field is used to extract location information for personalization. This field must be either an IPv4 address (e.g. &quot;104.133.9.80&quot;) or an IPv6 address (e.g. &quot;2001:0db8:85a3:0000:0000:8a2e:0370:7334&quot;). Otherwise, an INVALID_ARGUMENT error is returned. This should not be set when: * setting SearchRequest.user_info. * using the JavaScript tag in UserEventService.CollectUserEvent or if direct_user_request is set.

googleapiclient/discovery_cache/documents/retail.v2alpha.json

@@ -2800,7 +2800,7 @@
 }
 }
 },
-"revision": "20250515",
+"revision": "20250522",
 "rootUrl": "https://retail.googleapis.com/",
 "schemas": {
 "GoogleApiHttpBody": {
@@ -4743,7 +4743,7 @@
 "type": "object"
 },
 "GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestionSuggestedAnswer": {
-"description": "Suggested answers to the follow-up question.",
+"description": "Suggested answers to the follow-up question. If it's numerical attribute, only ProductAttributeInterval will be set. If it's textual attribute, only productAttributeValue will be set.",
 "id": "GoogleCloudRetailV2alphaConversationalSearchResponseFollowupQuestionSuggestedAnswer",
 "properties": {
 "productAttributeValue": {
@@ -7413,6 +7413,13 @@
 "$ref": "GoogleCloudRetailV2alphaSearchRequestTileNavigationSpec",
 "description": "Optional. This field specifies tile navigation related parameters."
 },
+"userAttributes": {
+"additionalProperties": {
+"$ref": "GoogleCloudRetailV2alphaStringList"
+},
+"description": "Optional. The user attributes that could be used for personalization of search results. * Populate at most 100 key-value pairs per query. * Only supports string keys and repeated string values. * Duplcate keys are not allowed within a single query. Example: user_attributes: [ { key: \"pets\" value { values: \"dog\" values: \"cat\" } }, { key: \"state\" value { values: \"CA\" } } ]",
+"type": "object"
+},
 "userInfo": {
 "$ref": "GoogleCloudRetailV2alphaUserInfo",
 "description": "User information."
@@ -8169,6 +8176,20 @@
 "properties": {},
 "type": "object"
 },
+"GoogleCloudRetailV2alphaStringList": {
+"description": "A list of string values.",
+"id": "GoogleCloudRetailV2alphaStringList",
+"properties": {
+"values": {
+"description": "String values.",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudRetailV2alphaTile": {
 "description": "This field specifies the tile information including an attribute key, attribute value. More fields will be added in the future, eg: product id or product counts, etc.",
 "id": "GoogleCloudRetailV2alphaTile",